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SVI-728 MSX COMPUTER QUICK REFERENCE CARD 


INTRODUCTION 


Welcome to the world of tomorrow. You have 
just made a purchase that will reward you 

for a long time to come. The SVI-MSX 728 
home Computer that you have purchased will 
open the doors to the future both today and in 
the future. The SPECTRAVIDEO family of 
personal computers contain features that will 
allow you to take advantage of all current 
computing technology and will also allow you 
to expand your horizons as new technology 
evolves, 

The SVI-MSX 728 is the tool that will allow you 
to deal with the computer revolution of the 
1980's and this is the manual for the operation 
of this tool. 

Again, welcome to tomorrow. Make it what 
you want it to be with you SVI- MSX 728. Just 
keep one thought in mind as you progress on 
your journey: A computer is only as smart as 
you make it. Without you, it’s only a rather 
complex bunch of wires, chips, metal and 
plastic. You are the most important 
component of your new computer system ! 


SYSTEM OVERVIEW 


SYSTEM OVERVIEW 


The terms in the following system overview 
might not be familiar to those:of you who are 
just beginning to learn about computers. But 
don’t worry. This manual was written 
especially for first time computer users to 
teach them the powerful MSX BASIC language 
that is built into the SVI-728. The overview is 
intended to give the beginner as well as the 
experienced user an appreciation of the power 
and beauty of the SV1-728: the first affordable 
and expandable personal computer. 


Your SV1-728 computer contains 3 powerful 
processors that allow you to display exciting 
pictures, play music or sound effects and 
control a program all at the same time! 


A Z80A 8-bit Microprocessor controls all the 
system components. It is responsible for 
storing, retrieving and executing programs. A 
video display processor (VDP) serves to 
generate all necessary video, control and 
synchronization signals. The VDP is capable 
of displaying 16 colors. It also supports 
manipulations of 32 sprites (shapes) and a 
maximum or 40 column text mode. 

In addition, there is a programmable sound 
generator (PSG) which can produce music or 
a wide variety of complex sounds. 


The MSX BASIC language is stored in the 32K 
bytes of Read Only Memory (ROM). Your 
instructions (or “programs” in computerese) 
to command the computer are stored in one 


SUPER MSX 
BASIC 


64K bytes of Random Access Memory (RAM). 
The remaining 16K is strictly for use by the 
VDP to store information with which it creates 
colorful graphic displays. 


The powerful MSX BASIC language written 
by Microsoft® is an extension of the same 
BASIC language that is available on computers 
costing three times as much as the SV1-728. 


If you are new to programming, you will find 
MSX BASIC to be a versatile, easy to learn and 
easy to use language. Experienced 
programmers will appreciate its powerful 
features and the flexibility it permits when 
writing, editing, debugging and running 
programs. 


The MSX BASIC has the following powerful 
built-in features: 


(a) Screen editor. 

(b) Full graphic and sound manipulation. 

(c) New SPRITE commands. 

(d) Default double precision math package for 
business application programs. 

(e) Special machine interrupt handling 
commands for real time BASIC 
programming. 

(f) Special function keys for often used 
commands (user programmable). 

(g) True upper and lower case display and 
Printing. 


REMEMBER: 

The secret to mastering the SV1-728’s power 

is to take your time reading this book 

and trying out all the exercises on your computer. 
Like driving a car, you must learn by doing. 

By correcting your mistakes and learning 

not to feel bad about them, you will succeed 

and grow with the Spectravideo’s line of 
expandable and affordable computer products. 


EXPANDABILITY To upgrade the computer, you can easily 
add more peripherals through the expansion 
module interface or game cartridge slot. You 
may install the SVI-707 MSX Disk Drive and 
the SVI-727 80 Column Video Cartridge to run 
CP/M programs; or else the speech synthesizer, 
the SVI-737 MSX 300 Baud Modem w/RS232. 
Besides, a wide variety of peripherals from other 
companies can also be used. Just name a few: 
music synthesizer, light pen etc. 


MSX is a trademark of Microsoft Corporation 
Microsoft® is a trademark of Microsoft Corporation. 
CP/M is the trademark of Digital Research. 
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@ UNPACKING 
@ SYSTEM INSTALLATION 


M@ POWER SUPPLY AND CABLES 
mM POWER-ON SELF-TEST 


UNPACKING THE The SVI-728 computer, video and audio cables, 
V1-728 power supply and switch box (for USA version only) 
are all securely packed in a foam cushioned carton. 
Please note: Save all packaging materials 
in case you must ship the unit for maintenance 
or repairs. 


SYSTEM 
INSTALLATION 
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Check the contents of your SV|-728 package. 
You should find the following items: 


SV1I-728 Home Computer 
Video cable and audio cable 
Switch box (for USA version) 
Power supply 

This instruction manual 
Warranty registration card 


asap > 


If any items are missing, please check with 
your dealer immediately. 


To connect the system, you will need two 
proper electrical outlets for your SV!I-728 
Computer and monitor or television set. 
Choose a comfortable position for operation, 
away from any source of extreme heat 
(sunlight, heaters, etc). 


Study the photos below carefully: 


aT V A/V GND 1/O SYSTEM PRINTER CASSETTE 
PORT PORT PORT PORT PORT 

TV PORT Connects your TV to the SVI-728 computer. 

AUDIO/VIDEO This port connects your monitor to the 

PORT SVI-728 computer. 

GND Ground. 

1/0 SYSTEM Connects the SVI-707 disk drive to the 

PORT SV 1-728 computer 


PRINTER PORT Connects to a Centronics-type printer. 
CASSETTE PORT Connects to a standard cassette recorder. 
GAME SLOT For MSX game cartridge and other peripherals. 
POWER SUPPLY Connects the power supply unit to the SVI-728 
SOCKET The other end of the supply unit is connected 
to an electrical wall outlet. 
POWER SWITCH Turns on the power to the SVI-728 
JOYSTICK PORT 1 For connection to a joystick. 


JOYSTICK PORT 2 For connection to second joystick. 
Joystick port 2 Joystick port 1 


The video cable that is required in the SVI-728 

computer system consists of 2 RCA phono 

plugs for video and audio on both ends. 

1. Connect one end of the RCA plugs into the 
video and audio ports on the rear of the 
SVI-728. 

2. Connect the RCA plug marked “video” to the 
video port and the RCA plug marked “audio” 
to the audio port on the rear of the monitor. 


NOTE: Some monitors require an inexpensive 
adapter to add to the RCA plugs before 
connecting them to the monitor. That is 
available from your local electronics dealer, 
We recommend the Radio Shack RCA Mini- 
Adapter (Model # 274-330). 


1. Connect one end of the RF Cable 
to the TV port at the rear of the computer, 
and the other end to the TV RF input. 


COMPUTER 


COMPUTER 
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CONNECT 
TOTV 


e | 
TV 


2. Connect the other end of the shielded video 
cable to the TV switch box. 


we. 


COMPUTER 


COMPUTER 


a 


+ CONNECT 


To TV 
VHF 


3. Disconnect the VHF TV antenna and 
reconnect it to the switch box’s connector 
marked TV. 


COMPUTER 
COMPUTER 
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TV 


HD coMMECT TO ANTENWA 


1. Connect one end of the cassette cable 
to the cassette port at the rear of the 
computer. 


‘ARNE ea EE RSS 


2. Insert the plugs on the other end of the 
cable to the corresponding jacks on the 
cassette recorder. 


EAR (White) 


CONNECTION TO 1. Connect one end of the SV1-207 
THE PRINTER Centronics Interface Cable to the 
printer port at the rear of the 


computer. 


2. Connect the other end of the cable to 
the connector of the printer. 


3. Plug the power cable of the printer to an 
electrical wall outlet. 


POWER SUPPLY 1. Before connecting the power supply, please 
AND CABLE check and be sure the power switch on the 
CONNECTIONS right side of the unit is OFF. 


2. Connect the cord coming from the power 
supply as shown, 
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TURNING ON 
THE POWER 


3. Connect the other end of the power supply to 
any wall outlet. 


After you have connected the SV1I-728 to your 
power supply, first turn on your TV then turn 
the SV1-728 power switch to the “ON” 
Position. There is a channel switch 3-4 

located at the bottom of keyboard. Select 

the proper channel (for USA users only). 


a 


iti 
i 
: 


—— 
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The POWER ON indicator will light up. 


POWER ON 
SELF-TEST 


GAME SLOT 


The SV1-728 has a built-in diagnostic check 
that will automatically check the function of 
the system. 


If the system still does not start up properly, 
refer to the trouble shooting chart. (Appendix G) 


The MSX GAME SLOT is located conveniently 
on the upper middle position. 

To insert or remove a MSX Cartridge, first be 
sure the power switch is in the OFF position. 


Game Slot 
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THE KEYBOARD 
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THE KEYBOARD 


Programming is generally done by sending 
instructions to the computer through the 
keyboard. Your instructions and the 
computer’s responses are visible on a TV 
screen, which is connected to the keyboard. 
The computer's keyboard should look 
somewhat familiar to you because it 
resembles that of a typewriter, However, the 
keyboard contains additional keys that are 
necessary to effectively communicate with the 
computer, 


Turn on you computer (remember, the 
ON/OFF switch is located on the right side of 
the computer). You are off to a good start if 
the screen looks like this when you turn the 
computer on. 


MSX System 
Version 10 


Copyright 1983 by Microsoft 


If you do not see anything on the screen 
immediately after turning on the 
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Ok 


CURSOR 


power, turn to the trouble shooting chart in 
Appendix G for assistance. 


After several seconds you will see the 
following information appear on the screen. 


MSX BASIC version 1.9 
Copyright 1983 by Microsoft 
28815 Bytes free 

Ok 


The word ‘Ok’ is the message to you from 
the computer that it is ready to accept your 
commands. The white square underneath the 
word “Ok” is called the “cursor.” Its position 
on the screen informs you of the location of 
the next letter you type. Let’s start typing and 
get acquainted with the SVI-728 and its special 
features that aid you in working with the 
computer. 


Begin by pressing the following keys: 
PRINT 


The cursor moves one position to the right 
every time you press a key. 


Now find the key (on the lower left 
side of the keyboard), and while holding it 
down, press the double quotation mark,| ¥ | ‘ 
key. This should cause the quotation marks to 
appear as on a typewriter. 


Type the following message: 
“ LONG LIVE THE SVI-728” 


Now make another double quotation mark at 


the end of the message by pressing 
and Seal . The screen should now look like this: 


MS X BASIC version 1.0 
Copyright 1983 by Microsoft 
28815 Bytes free 

Ok 


print “long live the SVI-728” @ 


If you ever make a mistake while typing - for 
example, you accidentally type the single quote 
mark instead of the double quotation mark - 

all you need to do is press the backspace key, 
and retype by pressing the and while 
holding it down, press the double quotation 
mark, [z_] Key. The backspace key permits 
easy retyping by erasing the character 
immediately to the left of the cursor. 


Now press the key and look at the 
screen. It will look like this: 


MSX BASIC version 1.9 
Copyright 1983 by Microsoft 
28815 Bytes free 

OK 

print “‘long tive the SVI-728” 


long live the SV1-728 


Ok 
S 
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—————————————— 
When you press the key while in 


immediate mode, you are telling the computer 
that you have finished working and that you 
want the computer to begin working. The 


your message on the screen. When it has 
finished obeying your instructions, it will 
display the Ok message to inform you that it 
is ready for more instructions. 


If you wish to type using upper case letters, 
you should press the key while 
pressing a letter key. Should you desire to 
type using only upper case letters for an 
extended period of time, you should press 
the key, located on the lower 
left side of the keyboard. 


The |_CAPS/LOCK | key toggles between the 
upper and lower case letters. When you wish 
to return to lower case letters, press the 


CAPS/LOCK | key a second time to unlock it. 


Now it's your turn to enter other messages in 
immediate mode. Don’t forget to press the 
key when you have placed the 
closing double quotation mark at the end of 
each message. If a message is longer than a 
single screen line, the computer will 
automatically advance to the next screen line, 
thus alleviating the need for a return key as on 
a typewriter (more on this last point later). 


If you misspell a word that is a BASIC 
command, such as PRINT, the following 
message will appear on the screen: 


PRINT “LONG LIVE THE SVI-728 
LONG LIVE THE SVI-728 
Ok 


PRONT “! AM THE GREATEST” 
Syntax error 
Ok 


KEYBOARD 
LAYOUT 


The Syntax error message tells you that 

you spelled an instruction incorrectly. Don’t 
worry, the computer is very forgiving and 
patient. We will explain how to correct this 
mistake in the next chapter. 


You can clear the entire screen at once by 
pressing the [CLS/HM | key located at the 
top right hand corner and the [SHIFT ] key 
simultaneously. The abbreviation “CLS” 
stands for ClearScreen. 


When you have finished practising entering 
messages for the computer to print, please 
continue reading. 


So far we have introduced you to the 
following keys: letter and number keys, the 
backspace key, the key and the 


key. All keys are shown 
below. 


The SV1-728 has many convenient features 
that are operated by certain keys. You will find 
these special keys to be both helpful and time 
saving. The remainder of this chapter will 
describe these keys, most of which will be new 
and some of which will be a review. 


FUNCTION 
KEY 


Look at the top row of keys on the keyboard, 
the ones highlighted below. 
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These keys are called “function” keys and 
each one is marked with the letter ‘’F’’ . They 
are a labor-saving device because they allow 
you to instruct the computer to perform a 
frequently used function by pressing only one 
key instead of having to type many keys. 


Here is a list of each key, the function it 
performs and a brief description of the 
function. 


KEY PRE-DEFINED FUNCTION 
Fl color 


F2 auto [ 18, 19] [ENTER 


F3 goto 

F4 list 

F5 run 
F6 color 15,4,7 
F7 cload” 

F8 cont 


F9 list. JENTER 
F10 [ELS] run [ENTER] 


Function keys F1 through F5 are operated by 
pressing the appropriate key. Function keys 
F6 through F10 are operated by pressing the 


key and holding it down while 


simultaneously pressing the appropriate key. 


COLOR 


AUTO 


GOTO 


LIST 


RUN 


COLOR 


CLOAD 


CONT 


LIST. 


RUN 


The COLOR command is used to change the 
text, background and border colors on your 
TV or monitor. 


The AUTO command is used to make the 
computer generate program line numbers 
automatically. This command is used very 
often, since all programming statements must 
be preceded by line numbers. 


GOTO is a command which provides you with 
the ability to execute your program from any 
place (line number) you desire, 


This command instructs your SV1-728 to print 
all of your immediately preceding program 
statements on the screen. LIST is probably 
the most often used computer command. 
RUN tells the computer to take the program 
you have written and perform the commands 
you have indicated, 


This tells the computer to print white letters 
on a blue background with a cyan border. 
These colors are the colors of the screen 
when you turn the computer on. 


CLOAD instructs the computer to input (load) 
data from a cassette recorder (which can be 
easily connected to your SV1-728. 


This command is used to tell the computer to 
“continue” program execution after the last 
executed line. 


With this LIST. (with a period next to it) only 
the last line you were working on (whether 
programming, editing, etc.) will be displayed 
on the screen. \ 


This command is similar to the standard RUN 
command. However this command also clears 
the screen before it ‘’runs’’ your program. 


a ee 


SHIFT 


NUMERIC 
KEYPAD and 
CURSOR 


CONTROL 
KEY 
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On the bottom of your TV screen, the SVI-728 
lists the function that each key performs. 


Fcolor auto Bgoto MM ist J run | 


color Micload’ Bi cont Mx list, Mm run | 


The SV1-728 will normally display the function 
of keys F1 through F5, and whenever you 

press the key it displays the function 
of keys F6 through F10. 


Any of these pre-defined functions can be 
quickly changed for your own convenience to 
a function that you frequently use. 


The numeric and cursor control keypad 
contains keys that are primarily used for 
simple numeric entry, word processing and 
cursor control. The followings are the 
commands that are accessed by this keypad. 


Numeric The numeric keys (0-9) are the same as the keys 
Keypad on the top of the regular keyboard. These are 
used when performing rapid entry of numeric 
data. This keypad also contains the 
mathematical functions keys (+, —, *, /) 
which can be used to enter formulae and to 
perform quick calculations. 


SELECT and The [SELECT]and|PRINT|keys are also included 

PRINT KEYS on this keypad to allow the advantage of using 
these functions that are often available in word 
processing and data entry software packages. 
These keys have no function in BASIC 
programming and are only accessed from 
programs such as those mentioned above. 


TENE TLS TREE 


30 


Arrow Keys 
(Cursor Control!) 


PROGRAM 
CONTROL 
KEY 


STOP 


The arrow keys (up, down, left & right) 
control the movement of the cursor on the 
display screen. By pressing a combination of 
the up and left arrow keys, you will cause the 
cursor to move towards the upper left corner 
of the display screen. Other combinations will 
work in the same fashion giving you 8 
directions of cursor movement using these 
keys, 


The followings are the program control keys 
used to control the operation of computer 
programs. 


The key. Press this key to pause the 
computer after you have instructed it to run 
or to perform a function (which makes it begin 
working on your program). Press the 
key a second time to instruct the computer to 
resume working on your program or a 
function. 


The CONTROL key. This key is used in 
conjunction with the STOP key. In effect, this 
tells the computer to stop what it’s doing and 
turn control back over to you (so that you can 
issue further instructions). Press the 
key while simultaneously pressing the | STOP 
key. 


————————————————— 
The key. Press this key at the end of 
ENTER each instruction you type. By pressing this 


key you are telling the computer to enter the 
instruction you just typed into its work space. 
As we previously mentioned, the 
key is not used to advance the cursor to the 
next screen line and therefore should not be 
confused with the return key on a typewriter. 
In the event that an instruction contains more 
characters than can fit on a single screen line, 
the computer will automatically advance the 
cursor to the next screen line. For example: 


PRINT “! WISH WE WOULD HURRY U 
P WITH THIS INTRODUCTION SO T 
HAT | CAN BEGIN TO PROGRAM" 


This long instruction cannot possibly fit onto a 
single screen line which has room for only 29 
characters. Whenever this happens, the 

computer will automatically advance you to 

the next line. In the above example, the 

key should only be pressed after you 
have typed the closing double quotation 

mark that follows the word PROGRAM. 


MISCELLANEOUS 
KEY 


CAPS The key — pressing this key 

LOCK will toggle the display characters from lower 
case to upper case or upper case to lower 
case, 


CLS/HM The key — pressing this key will 
“COPY move the cursor to the upper lefthand corner 
of the screen. When pressed together with the 
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INS 
PASTE 


fl uy yg ee Ed 


to the upper lefthand position (home) 
and clear the screen. 


The key — this key is used 


when you wish to insert characters within a 
line, Just move the cursor to the location 
where you wish to insert, then press this key 
and the text you type will be inserted. 


The key — press this key to 


delete the character under the cursor. 


This key is often used in software application 
programs. Its usual function is to interrupt the 
operation of a program or to continue 
operation following an interrupt (Escape), 


This key is not used in BASIC. It is often used 
in a word processor or similar application 
program to space forward 5 spaces to begin a 
paragraph. 


This key backs up the cursor one space. It 
deletes the character immediately to the left of 
the cursor prior to the key press. 


The key is used to select the 
graphic symbols that correspond to the keys. 
If you press the key and hold it 
down while simultaneously pressing one of 
the letter keys, the graphic symbol of the 
corresponding key displayed. 


The key is used to select the 
characters other than English that correspond 
to the keys. It you press the key 
and hold it down while simultaneously 
pressing one of the letter keys, the different 
language character of the corresponding key 
will be displayed. 


The details of the keyboard layout 
are shown below: 
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STANDARD KEYBOARD LAYOUT 
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STANDARD KEYBOARD LAYOUT 
WITH SHIFT KEY PRESSED 
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Now that you have learned how to hook up 
your computer and are familiar with the 
keyboard, you can proceed further in the 
manual. However, if you are anxious to begin 
using your computer, please turn to Appendix | 
for some simple demonstrations. 


After completing these exercises, return to 
chapter 3 to continue. 
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SCREEN 
EDITOR 


EASY EDITING 


The BASIC Screen Editor lets you change a 
line anywhere on the screen. You can change 
only one line at a time. The Screen Editor can 
be used after an Ok prompt appears and before 
a RUN command is issued. By using the 

Cursor Control keys and the editing keys, 

you can move quickly around the screen, 
making corrections where necessary. 


Here is an example to show you how to use the 
Screen Editor. 


Let’s enter the following program. 


10 REM SCREEN EDITOR DOMO 
20PRINT “DEMONSTRATION OF” 


30 END 


Note: Remember that a program line must 
always begin with a line number. If you make 


a mistake, just press | ENTER | and retype the 
line. 


2S 


After you have finished, press the 
and [SHIFT ] keys simultaneously, then type 
LIST or [F4] and press [ENTER] You 


should see: 


LIST 


18 REM SCREEN EDITOR DOMO 
28 PRINT “DEMONSTRATION OF” 


34 END 


Ok 


Now correct the word DOMO in line 10. First 
use the cursor key’s UP direction key to move 
to line 10 and then the RIGHT direction key to 
move the cursor to the top of the letter ‘O” of 
“DOMO”. 


19 REM SCREEN EDITOR D&@)MOo 
28 PRINT “DEMONSTRATION OF” 
38 END 


Ok 


Press the letter “‘E’’ to change the word to 
“DEMO” , then press . The line will be 


stored now as: 


19 REM SCREEN EDITOR DEMO 


You have just replaced the character ‘O"’ with 
the character E"’. To verify this, press 
and simultaneously, then CF4 ] 
(list), . You should see: 


18 REM SCREEN EDITOR DEMO 
26 PRINT “DEMONSTRATION OF” 
38 END 


Ok 


The next step is to insert the two words 
SCREEN EDITOR into line 20. We do this by 
moving the cursor to the second quote of Line 20. 


19 REM SCREEN EDITOR DEMO 
26 PRINT “DEMONSTRATION OF” 
39 END 


Ok 


INSERT Now press the , key and the 

MODE cursor will become half as tall as before. This 
means you are in the “INSERT” mode. Type 
“SCREEN EDITOR", bring the cursor back to 
the beginning of line 29, and press [ENTER | . 
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You have just inserted the words “SCREEN 
EDITOR” .Follow the steps you used to verify 
line 19 and you will see: 


10 REM SCREEN EDITOR DEMO 

28 PRINT “DEMONSTRATION OF 
SCREEN EDITOR” 

36 END 


Ok 


Besides using the Screen Editor, you can also 
change a line by entering a new one with the 
same line number. BASIC will automatically 
replace that line. 


A BASIC 
INTRODUCTION 
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A BASIC 
INTRODUCTION 


ABOUT THIS To be able to control a computer, you must 
BASIC TUTORIAL be able to communicate your instructions in a 
GUIDE language that the computer understands. The 


SV 1-728, like most personal computers, 
understands a language called BASIC 
(Beginner’s All Purpose Symbolic Instruction 
Code). This language, which is built right into 
the SV1-728, is a set of English words with 
which you can instruct the computer to 
perform certain functions. 


This manual differs in many ways from other 
manuals written to teach BASIC. One of the 
major differences is that most of the information 
presented in this tutorial has already been used 
successfully to teach BASIC in the classroom. 


This guide begins by describing those BASIC 
commands which allow you to design simple 
pictures and see them displayed on the TV 
screen. Our reason for introducing you to 
BASIC through graphics is simple. Learning 
BASIC is like learning a foreign language. If we 
can relate the new words of BASIC to the 
knowledge that you already possess about 
drawing, you can move smoothly into the 
computer age and have fun at the same time. 


In the next few chapters we will explain several 
commands which allow you to create pictures. 
But there is much more to learn about the 
SV1-728’'s graphic capabilities. It will be 
explained in greater depth in the latter chapters 
of this manual. 


a 


WHAT IS 
PROGRAMMING? 


Programming is the act of writing the 
instructions and information that must be given 
to the computer in order for it to perform a 
task. Programs differ from one another in that 
the instructions and information necessary for 
managing a household’s checkbook, for example, 
are different from the instructions and 
information needed to control a video game. 


Programs written in one computer language will 
not contain the instructions and structure that 

a program in another computer language 
possesses. That is why professional programmers 
generally must specialize in one or two languages. 
It is the rare individual who is even aware of all 
the different computer languages that have 

been developed in the past twenty years. 


There are two different ways to type a BASIC 
instruction into your computer: In ‘‘program”’ 
mode or in “‘immediate’’ mode. 


As its name implies, you are in “program” 
mode when you write a program. A BASIC 
program is a set of instructions typed one 
instruction after the other with a line number 
beginning each instruction line. For example: 


16 PRINT “1 AM” 
26 PRINT “STARTING TO” 
39 PRINT “LEARN BASIC” 


Line numbers are genera!ly in intervals of ten 

to allow for easy reference when corrections 

are required or when additional lines need to 

be inserted. The computer executes your program 
after you type the word RUN. 


The second way of instructing the computer is 
called “immediate” mode, because after each 
instruction is typed and the key is 
pressed, the computer will immediately respond. 
Do not precede the single line of instruction 
with a line number when you are in “‘immediate” 


mode. 
ONE WORD For most of the time spent with this tutorial, 
BEFORE WE you will be in program mode. If you are serious 
BEGIN about programming, then you will continue 


to write programs and very infrequently be in 
the immediate mode. The immediate mode is 
generally reserved for housekeeping details like 
saving programs on a Cassette tape or disk, 
requesting a catalog of your programs stored 
on a disk and loading information from a 
cassette or disk into the computer. 


We realize that these words and concepts are 
new for many of you, but don’t worry. These 
ideas will become clearer as you continue 
reading. 


The model that we are about to present is 
critical to your fully understanding how a 
computer works and what it does with the 
program you type in. 


Your interaction with the computer is similar 
to the following scenario. 


If you were interested in buying a car you 
would probably call a car dealer for a price on 
a particular model. You might ask the 
salesman for a price on a Cadillac with power 
windows, power steering, leather seats, deep 
pile carpeting, and tinted windows. The 
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salesman will then proceed to check his 
price lists, write the numbers down on a 
worksheet, add the numbers together and 
quote you the total price. 


Procedures to get information about a car. 


ASK 
SALESMAN 


SALESMAN 
CHECKS PRICE 


SALESMAN 
RESPONSE 


By the same token, when you work with a 
computer, the computer is the salesman. You 
tell the computer exactly what you want just 
as you tell the salesman and in both cases you 
get an answer. Similarly, in both instances 

you do not see the many calculations that both 
the salesman and the computer perform before 
informing you fo their answer. The instructions 
you give to the salesman or to the computer 

is the ‘INPUT’ they need to act on. 


The calculations done on the salesman’s 
worksheet are analogous to the wok performed 
in the computer’s erasable memory (called 
RAM or Random Access Memory), and the 
answer you get is called, the ‘OUTPUT’. 


By reading and practising the new language you 
have started to learn, you will be entering the 
ever expanding computer world. BASIC is only 
the beginning. 


ENJOY. 
RS TT NRE RES RTE 


WRITE YOUR FIRST 
PROGRAM 
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GETTING 
STARTED 


WRITE YOUR FIRST 
PROGRAM 


The easiest way to draw pictures on the 
computer is similar to the way one plays the 
game Battleship. 


The goal of Battleship is to try to guess the 
positions of your opponent’s ships. The game 
board for Battleship looks like this: 


Figure 1 Battleship Game Board 


Figure 1 shows how your opponent has his 
board set up. One of his ships is at positions 
H-2, H-3, H-4, and H-5. His other ship is at 
positions C-7 and D-7. 
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COORDINATES 


0 2 
123456789 123456789 
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You must seek out his ships by calling the 
names of positions on the board. In this 
example, if you were to call H-2 he would 
reply that you hit his ship, but if you said H-1, 
he would have told you that you missed. 


The important lesson to learn here is the way 
you give names to each of the positions on the 
board. In essence, each position on the 
Battleship game board is a point on a graph. 


To draw on the SV1-728 you must also give a 
name to each box of the grid that is shown in 
Figure 2. 


w» 40 bt) 60 
123456789 123456769 123456789 123456789 ’ 


Figure 2 


Each box has a name. The name is composed 
of two numbers: the number at the top of a 
column, and the number at the side 
designating each row. The first number is the 
horizontal location and the second number is 
the vertical location. These two numbers are 
called: the coordinate numbers of a point. 


2% 
2? 
2 
a 
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Understanding how to name boxes is very 
important for creating simple pictures. It is 
especially important because we are going to 
introduce through which pictures can be 
created. Spend a moment on the following 
exercise before proceeding to the next 
section. 


In Figure 3, several boxes are darkened. This 
signifies that they have been lit. Do you know 
the names of these boxes? Write them down on 
a piece of paper. 


“0 <i 40 


» 
34567869 $23456789 123456789 123456789 123456789 


Figure 3 


Your answers should have been 
A: (28, 19) 
B: (28, 20) 
C: (20, 38) 
D: (2, 49) 


Now we will use these names in a program 
which will light the boxes in Figure 3. Type 
on the keyboard exactly what is listed below. 


we EE 
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LIST 


Don't forget to press at the end of 


each line. We will not always remind you from 


this point on. Pressing after each 


instruction should become second nature to 
you by the time you finish this book. 


10 SCREEN 3 

20 PSET (70,50) 
30 PSET (66,54) 
40 PSET (74,54) 
50 PSET (62,58) 


60 PSET (78,58) 
70 PSET (66,62) 
80 PSET (74,62) 
90 PSET (70,66) 
100 END 


After you have checked to make certain that 
your program matches our program, type 
RUN. 


What's the matter? Did the picture flash by 
too quickly? Don‘t worry we expected that 
little problem to occur. Do the following: 


1. Type: 
LIST 
Ok 


Your program is displayed again on the 
screen. As its name implies, LIST will list your 
whole program from beginning line number to 
the last number you used. If you typed LIST 
when you were in immediate mode and not 
using the line numbers, you would not see a 
program listed. 


2. Type in the following new line. 


95 GOTO 95 


amc onmrataanemme seen Mme at pater Santen 
3. Type LIST 


Notice that line 95 was inserted between lines 
96 and 19@ automatically by the computer. 
Remember what we had said earlier in this 
guide about line numbers and why we usually 
use numbers with an interval of ten between 
them. The insertion of additional lines is a 
natural occurrence when you write programs. 


4. Type RUN 


The computer not only draws the shape we 
want, but it also keeps the picture on the 
screen forever and does not allow you to type 
in anything at the keyboard. Try typing. The 
characters you type don’t appear on the TV. 
Why? Because the machine is still RUNning 
your program and will continue to do so until 
you press the + keys 
simultaneously. Let’s look at the program 
again. 


10 SCREEN 3 

20 PSET (70,50) 
30 PSET (66,54) 
40 PSET (74,54) 
50 PSET (62,58) 


60 PSET (78,58) 
70 PSET (66,62) 
80 PSET (74,62) 
90 PSET (70,66) 
95 GOTO 95 
106 END 


Before we added line 95, the picture appeared 
momentarily and then disappeared because 
the program did exactly what it was supposed 
to do (very quickly) and then disappeared. By 
adding Line 95, we told the computer to stay 
right where it is. To stop the program, press 
the + keys simultaneously. 


SELL TOS RT SAMNRET 


SCREEN 


—————————EEEE 
The [CTRL | + keys combination 


breaks the computer out of its continuous loop, 
and will stop the computer from whatever 
program happens to be RUNning. 


You will see whatever you type appear on the 


TV. Remember to press after you 


finish each line. 


10 SCREEN 3 
20 PSET (10,20) 
30 PSET (26,20) 


40 PSET (36,20) 
50 PSET (40,20) 
60 GOTO 60 
76 END 


Line 18 tells the computer that you are going to 
draw a picture on SCREEN 3. 


There are 4 screens: 


SCREEN § - This screen allows you to enter 23 
lines of text with a maximum of 39 characters on 
each line before the display starts to ‘‘scroll” or 
move up. 


SCREEN 1- The screen the computer displays 
when you turn it on. This screen allows you to 
enter 23 lines of text with a maximum of 29 
characters on each line before the display starts 
to “’scroll’’ or move up. 


Both of the two screens allows you to 
communicate with your computer and 

tell him what to do for you: type in your 
commands in the immediate mode, or type 
in your programs. 


SCREEN 2- The High Resolution graphics 
screen which you use to draw High Resolution 
graphics. 


SCREEN 3- The Low Resolution graphics 
screen which you use for drawing Low Resolution 
graphics. 


(More about High and Low Resolution you will 
find in Appendix F) 


Whenever you CTRL-STOP a RUNning program 
which uses SCREEN 2 or SCREEN 3, the 
computer will automatically return to SCREEN @ 
or 1 (the previous text screen) program you by 
displaying the ‘‘Ok” message and the cursor. This 
will allow you to review (LIST) your program and 
make your modifications. 


PSET Line 28 introduces the PSET instruction. 
PSET tells the computer to turn on the box 
that is named (18,20). Remember, the first 
number in parentheses refers to the column 
and the second number refers to the row of 
the box. 


Lines 36-5@ continue to turn on the boxes we 
see darkened in Figure 3. Line 69 will soon 
be explained. 


Now type RUN and your picture will 
be displayed. When you finish viewing your 
work, press the and keys 


simultaneously to stop the program. 


What you typed into the computer was your 
first program. Giving several instructions to 

the computer at once is generally more 
efficient than giving the computer one 
instruction at a time in immediate mode. 
(Remember that in immediate mode the computer 
executes the command you type immediately 
after you press the key.) If we 
didn’t use line numbers to signify that we were 
writing a program but rather told the computer 
to turn on one box at a time, it would be 

like going to a supermarket ten times in one 
day and each time buying only one item. That 
would be a terrible waste of gas and time. 
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LET'S ADD SOME 
COLOR 


After all this talk, it is time for you to practise 
what we have been preaching. 


NEW tells the computer to forget about the 
program you had previously typed. 


Type NEW 


Try to write a program that draws the shape in 
Figure 4. 


Figure 4 


Each of the boxes you light up can be in one 
of 16 colors. Here is a list of the 16 colors the 
computer uses and the corresponding number 
for each color. 


COLOR # COLOR 
8 TRANSPARENT 
1 BLACK 
2 MEDIUM GREEN 
3 LIGHT GREEN 
4 DARK BLUE 
5 LIGHT BLUE 
6 DARK RED 
7 CYAN 
8 MEDIUM RED 
9 LIGHT RED 
18 DARK YELLOW 
11 LIGHT YELLOW 
12 DARK GREEN 
13 MAGENTA 
14 GRAY 
15 WHITE 


Before describing how to add colors to your 
drawings we will first demonstrate your 
computer’s vivid colors. 


pF 
Press the [CLS/HM | and keys to 


clear the screen and type the following: 


COLOR 4, 15 ENTER 


(Note that function key #1 Ga can generate the 
word ‘‘color’’ for you] 


The colors of the background and text 
are now reversed, The numbers 4 and 15 
represent two of the 16 colors listed above. 


Let's experiment with the COLOR command. 
Begin by typing: 


COLOR 4,4 


The text disappeared and the only thing you 
see is a blue screen. Now type your 

name. You should hear the clicking sound but 
no characters are displayed on the screen. Here 
is why: 


The first number following the COLOR 
command is the color you are instructing the 
computer to use for the display of text while 
the second number is the color the computer 
will use for the background. Since you 
instructed the computer to use the same blue 
color (4) for both the text and the background 
the text seemed to disappear. In other words, 
what you type is printed on the screen, you 

just can’t see it! In order to return to “visible” 
text you need to type a new COLOR command, 
but it would not be easy without seeing the cusor 
or what you typed. 


Now you could appreciate the usefulness of 
function key #6. 


First make sure that the cursor (which you 
cannot see) is positioned at the beginning of a 
“clean” new line. You do this simply by 


pressing | ENTER 


———— ee 


BORDER 
BACKGROUND 
and 
FOREGROUND 


You will still not see anything changed, but 

you will hear a beep. Since the last thing you 
typed was your name, by pressing the 
key you caused the computer to generate a 
“*Syntax error’’ message which is always 
accompanied by a short “warning” beep. 

This of course, wouldn't happen if your name 

is a correct command in the BASIC language. 


Now, press the key and while holding it 
down press function key # (F6). The display 
returns to normal and you should see now all 

the words you previously typed plus the ‘Syntax 
error” and ““Ok"’ messages. 


Take a look at the last color command on the 
screen: 
COLOR, 15,4, 4 


this is the command you gave the computer by 
using[F6] (Note that you didn’t have to 
[ENTER}this command, since[F6] ENTERs 
automatically. You see that there is a third 
number added to the color command. We 
already know that the first number (15) is the 
text color, and that the second number ( 4) is 
the background color. The third number (7) is 
the color the computer uses for the border of 
the screen. The border is usually not displayed 
in the text mode (screen @ and 1). That’s why the 
need to specify a border color exists mostly 
when you are using SCREEN 2 or SCREEN 3. 


We may think of the screen’s display as of 
three layers, one on top of the other. At the 
bottom there is the Border, above it there is 
the Background which in the text mode, or 
SCREEN @ or 1, covers the Border totally; and in 
the graphic screen (2 or 3) ‘‘grows down” in 
size and “exposes” the Border at the top and 
bottom of the screen . 

Above the Background comes the Fareground 
which might be described as a clear acetate 
layer that “carries” all the images that appear 


on the screen: on SCREEN @ or 1 it’s the text, 
and on SCREEN 2 or 3 it’s the graphic image. 


If you understood this concept you should feel 
comfortable with the following fomat 
description: the format of the COLOR 
command is 


COLOR, <foreground color #> , 
<background color #>, 
< border color #> 


Now, experiment with the numbers to get 
familiar with all the colors. 


O.k. Let’s get back to the PSET command 
PSET (10,26) 3 


Now change the color, 


PSET (18,2), 8 


The PSET command only scratches the 
surface of the almost unlimited graphic 
capabilities of the SVI-728. The majority of 
commands to create exciting pictures on your 
computer will be described after we have 
introduced you to the BASIC language. 


GOTO Before we end this chapter, type in this 


popular little program that uses the GOTO 
command in a way that is easily understood. 


First type NEW 


and then 


10 PRINT “I LOVE MY SVI-728 


COMPUTER” 
28 GOTO 16 


now type RUN. 
(Geter Saat SET rE 


Press the + keys combination 
to stop the runaway program. Do you 
understand why the machine printed “| LOVE 
MY SVI-728 COMPUTER” again and again? 
Here’s why. 


Line 1 tells the computer to PRINT the 
message between the parentheses on the 
screen. And Line 20 tells the computer to go 
back to line 18 and print the message again. 
After it is printed a second time, the computer 
reaches line 20 again and is sent back again to 
line 18 and then again and again . . . to infinity. 
Now try inserting other messages in between 
the parentheses in line 18. The quickest way 

to change line 10 is as follows: 


First type LIST 


to see your program. Don’t forget to press 


Next retype 


19 PRINT ” 


Now add any message you want, such as your 
name, and put a closing quotation mark at the 
end of your message. After you have finished 
retyping line 10 and pressed , the 
change has been entered in the computer's 
memory. 


Now type RUN 


and the revised message should appear on the 
screen. We will have more to say about the 
PRINT command in a later chapter. 


We suggest that you read appendix F now 
for clarification on screen modes, before go 
to next chapter. 


GOING THROUGH 
THE LOOPS 
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GOING THROUGH 
THE LOOPS 


After using the PSET command in the previous 
chapter, you probably thought: there has to be 
a way to turn on the lights of particular boxes 
that is quicker than having to name each box 
individually. Well there is! But before we show 
it to you, first type in the following program: 


In MSX-BASIC there 19CLS 

is a nice shortcut that 26 PRINT “TELL ME A NUMBER” 
saves yOu fram 30 INPUT Y 

always having to 40 SCREEN 3 

type out the word 50 PSET (38,Y) 

command PRINT- 60 PSET (45,Y) 

just typeiin a 70 PSET (69,Y) 

question mark (?)-it 80 PSET (75,Y) 


serves the very same 909 GOTO 90 


purpose! 


Now type RUN 


Your program should have disappeared and 
the message ““TELL ME A NUMBER” should 
suddenly appear on a cleared screen. The 
screen was cleared, thanks to the CLS 
command which stands for “‘ClearScreen”’, 
which is on line 19. 


The message is output to the screen by the 
PRINT command in line 20, and the cursor 
should appear just after a question mark. 


INPUT The question mark was put there by the 
command INPUT, INPUT tells the computer 
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CONTAINERS 
and VARIABLES 


The type of a 
variable container 
this 
chapter is a numeric 
This is 
used for the storage 


discussed ir 


container 


of numeric values 
only, Non-numeric 
variables 

or Alpha-numeric 
variables will be 
discussed in 
chapter 8 


to wait and not go on to the next instruction 
of the program until you type something in at 
the keyboard. Whatever you type in is stored in 
a “container’’ in the computer's erasable 
memory. 


The more technically oriented of our readers 
will recognize that the container we are 
referring to is a variable. The following 
explanation about the way a computer uses 
containers to store information is meant for 
those readers who aren't comfortable with the 
term “variable’’, 


Before we continue with the description of 
containers, let’s first observe a container in 
action. First type in a number between 0-191 
and press . (If you press a number 


greater than 191, you will get a blank screen.) 


If you typed in a number between 0-191 and 
pressed , a line should have been 
drawn on the screen. The location of that line 
depends on the number you typed in. Here is 
why. 


The number you typed is stored in a container 
called ‘’Y’’, as designated in line 30. Think of 
“Y" as a cup, and the number you typed as a 
mark on a piece of paper that is placed in the 
cup. When the computer reaches line 58 and 

it is time to turn on the box that is specified by 
the name (38,Y), the computer looks in the 
cup marked “Y”’ and substitutes the number 
you typed in for the letter Y wherever “Y” 
appears. So if you had typed in 27, the 
number 27 would be stored in the container 
““Y"", When the computer reaches line 5@ it 
will light up box (39, 27); at line 68 box 

(45, 27); at line 78 box (68, 27); and finally at 
line 8, box (75, 27). 


CONTAINERS IN _ It would be very difficult to store and retrieve 

THE COMPUTER'S information if we did not have a clear way of 

MEMORY referring to the information we use. Thus we 
have chosen the term “‘container” to 
designate a particular location in the 
computer's erasable memory where 
information is stored. The letter “Y”’ is only 
one of many possible symbols we can use to 
“name” the containers. 


A container’s name can be thought of as the 
number part of the address of your home. Ifa 
friend mails a letter to you and the envelope 
bears only the name of the street you live on 
but not the specific number of your house, it 
is quite possible that your mail will be placed 
in the wrong box, Similary, if we feed into the 
computer information that is not ‘‘correctly 
addressed", we will have a hard time finding 
the information we need later on. Our ability 
to communicate with the computer will then 
be severely limited. 


ONE LAST The SV1I-728, like most personal computers, 
WORD ABOUT uses two different sets of containers. One set 
CONTAINERS of containers holds only numbers, the second 


set holds both numbers and words. 


A container whose name begins with the 
letters A-Z holds only numbers but when a 
dollar sign, “’$’’, is placed after the letters it 
can hold both numbers and words. A 
container name can be up to 2 characters in 
length-it can’t be a word of BASIC Language- 
for example, SV, DL, HF, L1, etc, are legal 
containers names. Type: 


10 CLS 

20 PRINT “WHATEVER YOU TYPE IN 
WHEN THE QUESTION MARK 
APPEARS, ! WILL REPEAT” 

30 INPUT A$ 


40 PRINT A$ 
50 END 
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CONTAINER 
STORAGE AND 
RECALL 


Type RUN 


Then type a number in response to the dollar 
sign, and watch the computer echo whatever 
you typed (remember to press when 


you finish your input). 
Then type RUN 


again and this time type in a word or two in 
response to the question mark (and press 


[ENTER] ). 


What happens when you mix both numbers 
and words in the same container? Is the 
mixture accepted? Try it by RUNning the 
program again. 


You may store a maximum of 255 characters 
(letters) in any one container. Likewise, you 
can type a maximum of 255 characters on any 
one line of your BASIC program. Experiment 
to see what happens when you try typing 

more than 255 characters. RUN the program 
again, and this time type more than 255 
characters after the question mark and then 
press . You should see that the extra 
characters were ignored. 


There are various commands that tell the 
computer what information to put into a 
specific container. We have already seen that 
INPUT puts the information that you type into 
a container. Here is another way. Type, 


19 CLS 

20 LET A= 10 
30 LET B= 20 
49 LETC=A+B 


50 PRINT C 
69 END 


LET 


Now type RUN 


The number 30 should have been printed out 
on the screen. This program illustrates how 
one assigns information to containers. The 
command LET prefixed the name of the 
container you wish to use and the container is 
placed on the left side of the equal (=) sign. 
The information you wish to place into the 
container is written on the right side of the 
equal (=) sign. After the number 10 has been 
placed in “A” and the number 20 has been 
placed in “‘B’’, the computer adds the 
numbers together and places the sum into 
container ““C’’. Thus the computer’s answer is 
found in container “C” and the contents of 
container ‘‘C’’ are printed on the screen. 

You do not have to use the command LET to 
assign information to a container. The 
following program does exactly the same 
thing: 


19 CLS 
20 A= 10 
39 B= 20 


46C=A+B 
50 PRINT C 
69 END 


The use of LET generally helps to improve the 
readability of your program. This is helpful 
when someone else looks at it, or when you 
look at it after not reading it for a long period 
of time. 


Now we'll show you another way to use 
containers .. . one that allows you to draw 
quickly. 
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FOR/NEXT 


The following techniques will not only help 
you to draw quickly — they will also prove to 
be invaluable in almost any program you 
write. Type and RUN the following program: 


10 CLS 
20 FOR X = 0 TO 64 
30 PRINT X 


40 NEXT X 
50 END 


Surprised at the result? You really should not 
be. This program uses the same kind of loop 
and container that we have been discussing. 


After line 10 clears the screen, line 20 instructs 
the computer to place all the numbers 
between @ and 64 into the ‘’X”’ container one 
at a time. The obedient computer begins by 
putting a @ in the “X” container. The 
instruction to PRINT X on line 3@ forces the 
computer to look up the number stored in the 
“X" container and display it on the TV. Then 
on line 4@ the computer is instructed to take 
the next number after @ and place that in the 
“X" container. Since a container can hold only 
one item at a time, the @ is erased from the 
“X" location in the computer's erasable 
memory and the number 1 is now placed in 
the ‘X"’ container. Then the computer is sent 
back to line 20 to begin tne process again. 


Since the number 1 is one of the numbers 
designated to be placed in “X”’, the computer 
proceeds to line 30 where it finds the number 
1 stored in “X”, and proceeds to PRINT the 
number 1 an the screen. Line 4% causes the 
number 2 in the container and returns the 
computer to line 20 where the same events 
occur. This loop continues until the number 
64 has been placed in “’X’’ and has been 
displayed on the screen. Since 65 is not one 


of the designated numbers on line 20, the 
computer sees the END command on line 50 
and stops. 


The FOR-NEXT commands are always a 
pair. Never use one without the other. The 
FOR-NEXT loop is fundamentally different 
from the loop we can create with the GOTO 
command. As your programming skills 
develop, you will learn when the use of each 
is appropriate. 


Do you think you can change the 

program which printed out the numbers 
between 0-255 to draw a straight line across 

the whole screen? Before you read how it’s 
done, try it yourself. Hint: Two lines have to be 
changed and lines added. 


16 SCREEN 3 
20 FOR X = 9 TO 255 


30 PSET (X,25) 
40 NEXT X 
59 END 


Type RUN and watch how effortlessly the 
computer draws that line! 


The computer is told on line 20 to put all the 
numbers between @-255 into ‘’X” container 
one at a time. A@ is placed in “X”’ in line 20. 
And when the instruction to turn on the box 
named (X,25) is given in line 30, the computer 
checks to see what number is stored in “’X” 
and substitutes the @ for the container name 
in the name of the box, so the first box lit is 
box (9,25). 


NEXT X on line 49 places the number 1 in 
“X"’, Since 1 is a designated number, the 
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SOME TIME 
SAVING HINTS 


second box the computer lights up is box 
(1,25). The number one stored in “X"’ is 
substituted for the “’X”’ in line 49. This loop 
continues until all 255 boxes in row 25 have 
been lit, 


Now try changing the loop program which 
draws a horiztonal line on row 25 to one that 
will draw a vertical line at column 30 from the 
top of the screen. Your program should look 
like this: 


10 CLS 
20 SCREEN 3 
39 FOR D=9 TO 191 


40 PSET (39,D) 
50 NEXT D 
69 END 


Notice that we use a different container name. 
“Dis the designated container that will hold 
all the numbers between 9-191. This looping 
program works exactly like the program above, 
that draws the horizontal line. 


We have spent much time explaining to you 
how containers work in a non-technical way. 
This was important because the more you 
know about how the computer works and the 
precise cause-and-effect of every command in 
BASIC, the better use you can make of the 
SV1-728 features. 


We have seen how loops can save you time. 
Another little time saving tip is this. You need 
not always place the END command at the 
end of every BASIC program. Although it is 
good practice to do so, you will quickly learn 
where END is necessary. 


END 


10 CLS 


20 PRINT “| LOVE MY SVI-728” 
39 GOTO 26 


The END command is not needed at the end of 
this program because the way the program is 

structured the computer will never pass line 30. 
It will be caught in a continuous loop until you 


press the [ CTRL ] + keys combination. 


Similarly, you need not always precede your 
program with 


16 CLS 


You should decide when you have to work 
with a clear screen and when you don’t. 


When using the SCREEN command you do 

not need to use the CLS command because 

the SCREEN command automatically clears 
the screen. 
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SETTING THINGS IN 
MOTION 
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SETTING THINGS IN 
MOTION 


Now that you know how to use containers to 
draw a line, let’s add one line to the program 

you did in the previous chapter. This addition 
will cause a dot to move across the screen, 


10 SCREEN 3 
20 FOR X = @ TO 255 


30 PSET (X,25),11 
49 PRESET (X,25) 
59 NEXT X 


RUN 


Was that a bit too quick for you? Before we 
show you how to slow the bouncing ball 
down, let's review this program to learn how 
we create the illusion of motion. 


PRESET The new command PRESET on line 49, acts 
just the opposite of PSET. PSET turns boxes 
on and PRESET turns boxes off. In our 
program above, PRESET turns off the very 
same box that PSET turned on. In line 30 we 
told PSET with what color to light the boxes. 
In line 48 we don’t have to tell PRESET a color 
number. PRESET merely turns the box off to 
the background color of the screen. 


How can we slow our bouncing ball down? 
Well, it makes sense to somehow slow down 
the computer so it will be delayed between 
line 39 and line 49, because the slower the 
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boxes get turned off, the longer they will stay 
on and the easier it will be for an observer to 
follow the path of the ball. We will add what 
is known in computer jargon as a time delay 
between line 30 and line 4@. 


Add the following lines: 


35 FOR T=0 TO 56 


37 NEXT T 


Now type LIST 
and your program should look like this: 
10 SCREEN 3 


20 FOR X = @ TO 255 
30 PSET (X,25), 11 


35 FOR T= 9 TO 50 
37 NEXT T 

40 PRESET (X,25) 
50 NEXT X 


Now type RUN. 


Your program should now be considerably 
easier to your eyes because the dot will move 
more slowly across the screen. Lines 35 and 

37 should look familiar to you. They are an 
example of your typical FOR-NEXT loop, with 
an important difference. 


In the previous chapter we stuck a command 
(such as PSET or PRINT) between the FOR X 
and the NEXT X commands. In the bouncing 
ball program we did no such thing. Rather, by 
placing the FOR T and the NEXT T 
commands on consecutive lines, we caused 
the computer to wait a certain amount of time 
before proceeding to line 40. Lines 35 and 37 


WALKING 
BACKWARD 


caused the computer to stop and count from 
@ to 50. The computer merely placed the 
numbers between @ and 59 into the container 
called “’T’’ one after the other, and that took 
up time. Hence, this use of the FOR-NEXT 
loop is called a ‘time delay”. 


To speed up the moving dot, simply change 
the last number you want to be placed in the 
“T" container to a number less than 50. For 
example, 


35 FOR T=9 TO 25 


37 NEXT T 


To slow down the bouncing ball, simply 
increase the last number to be placed in the T 
container to a number greater than 58. For 
example, 


35 FOR T = 0 TO 100 
37 NEXT T 


Now that you have mastered how to make the 
ball move forward, from left to right, it is time 
to make the ball move backward, from right 
to left. Add the following lines to the 
bouncing ball program: 


60 FOR Q = 255 TOO STEP-1 
76 PSET (Q,25), 11 
89 FOR F = 9 TO 10 


90 NEXT F 
108 PRESET (Q,25) 
119 NEXTQ 


STEP 


The new addition to the revised bouncing ball 
program is the line 69. You are probably 
wondering where the STEP — 1 came from. 
Here’s why. 


The instruction 


FOR X = @ TO 255 


means that the computer is instructed to place 
all the numbers between @ and 256 into the 
“X"' container one at a time. The ‘‘one at a 
time” instruction need not be written 
explicitly. 


FOR Q=@ TO 255 


is equivalent to 
FOR Q=@ TO 255 STEP 1 


Which means move from @ to the next 
number, one at a time. When you do not 
specify how many numbers to STEP to, the 
computer automatically assumes you mean to 
advance by one number at a time. We could 
just as easily have instructed the computer to 
jump from @ to 2 with the instruction, 


FOR Q=9@ TO 255 STEP 2 


Therefore, line 69, 
FOR QO = 255 TO @ STEP—1 


is interpreted by the computer to mean placing 
all the numbers between 255 and @ into 
container ‘‘Q’’ one number at a time in 
descending order. That is how we get the ball 
to move backward . 


By deleting just one line you can see a 
drastically different result. The present 
program bounces the ball back and forth 
across the screen. Try it. Delete line 189 by 


typing. 


100 


Now type LIST. 


FIRST 
CHALLENGING 
PROGRAM 


To prove to yourself that line 100 was erased, 
type: 


RUN 


When you deleted line 100, the boxes that are 
lit up by line 7@ are no longer turned off. Now 
change the program by adding one line which 
will make it get stuck in a continuous loop. 
Try it before you read on. 


You should have added, 
120 GOTO 26 


This addition tells the computer to return to 
line 20 and start drawing the ball and the line 
again, It looks like a little yo-yo. 


Using all the materials you have learned up to 
this point, try writing a program that will 
create a picture in which a ball tumbles down 
a staircase. This program is tricky, but 
remember we have placed it here to really 
challenge you. It should be easier to tackle if 
you first instruct the computer to draw a 
staircase and then concentrate on making a 
ball move down the stairs. The finished 
product should resemble the picture in 
Figure 5, 


Figure 5 
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REM 


Our program to accomplish this task is listed 
below. 


REM THIS SECTION OF THE 
PROGRAM DRAWS A 
STAIRCASE 
SCREEN 3 
FOR X=@ TO 191 
PSET (X,Y), 6 
yY=Y+1 
NEXT 
REM THIS SECTION OF THE 
PROGRAM DRAWS THE BALL 
TUMBLING DOWN THE STAIRS 
66 Y=0 
70 FOR X=47T0191 
88 PSET (X,Y), 15 
199 FOR T=9 TO 168 
195 NEXT T 
119 PRESET (X,Y) 
120 Y=V+1 
125 NEXT X 
135 CLS 
149 Y=0 
159 GOTO 29 


The above program does exactly what we had 
set out to do. The only new command 
introduced here is REM. REM is the 
abbreviated form of remark. When REM 
appears at the beginning of a program line, {in 
this program, lines 5 and 55), the computer 
understands that it should ignore whatever 
follows the REM command on the same line. 
REM statements are comments which are 
used to increase the readability of a program. 


Lines 40 and 129 use containers in a way that 
is familiar to people who remember basic 
algebra. The instruction “Y = Y + 1” tells 

the computer to add 1 to the number that is 


stored in the “Y"’ container and then place the 
new number back in the ““Y”’ container. 


If you were not able to complete the staircase 
program, do not be discouraged. As 
mentioned at the beginning of this guide, we 
differ from other tutorial texts in many ways. 
In addition to offering in-depth, non-technical 
explanations of the BASIC commands we also 
supply you with challenging exercises. 


ee 
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1F/THEN 


DECISION MAKING 


Up until now we have been introducing you to 
the BASIC language through graphics. Now 
we will begin to explore many other BASIC 
commands in different settings. 


In order to program the computer to make 
decisions, we use the instruction known as 
the IF-THEN statement. (Note: this is the first 
time we have used the word ‘program’ as a 
verb. Previously we used this word as a noun, 
but the verb for creating a program is 
programming and we will start using this 
official term.) Let’s see how it works. Enter 
(this is the verb we will now be using 
alternatively for the word “‘type’’) the 
following program: 


10 CLS 

20 PRINT “TRY TO GUESS THE 
NUMBER THAT | AM THINKING 
OF. I’LL GIVE YOU A HINT. IT 
IS BETWEEN @ AND 169.” 

30 A=50 

49 INPUT X 

50 IF X= A THEN GOTO 166 

69 PRINT “SORRY, YOU DID NOT 
GUESS IT. TRY AGAIN.” 

79 GOTO 49 

190 PRINT “GREAT GUESS. YOU ARE 

CORRECT, THE NUMBER | WAS 
THINKING OF IS 59.” 
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STRING 
VARIABLE 


Now RUN the program. The INPUT command 
in line 4@ will cause a question mark to appear 
on the screen. Enter your guess after the 
question mark. Line 5@ of the program 
compares your guess that is stored in 
container ‘’X" with the number that is stored 
in container “A’’. If you guessed the number 
56 then the computer will jump to line 199. If 
you did not guess the number 5@, and 
container ‘’X"’ holds any other number, the 
computer automatically continues to line 69. 
There, it informs you of the result and sends 
you back to line 49 which places another 
question mark on the screen and waits 
patiently for your next guess. If you entered 
50 as your guess, then the test on line 50 
sends you to line 19% which prints out the 
appropriate message. Let’s take a closer look 
at the IF-THEN statement. Like the 
FOR-NEXT loop, the IF-THEN command is 
used very frequently. 


The IF-THEN statement performs a test. In 

our example the command meant: if X= A 
was true then the computer must jump to line 
109. If the test proved to be false (the number 
stored in ““X” did not equal the number stored 
in “A‘’), then no action was to be taken (e.g. 
do not jump to line 19@). Instead the computer 
just continues with the next line in order. 


In chapter 6 we mentioned that your computer 
uses 2 different types of containers: One kind 
stores only numbers and is called a “Numeric 
Variable,’’ while the other store both letters 
(words) and/or numbers as long as they are 
placed between double quotation marks. This 
variable is called a ‘’String Variable” (Because 
a word is a group of characters that are strung 
together). 


To differentiate between the two types of 


variables a dollar sign ($) is placed after the 
name you choose for the variable. 


Example: A$ = ““VARIABLE” 
BS = “2 Variables” 
c$ = #4934" 


We will now challenge you to write a program 
that requires the use of a String Variable. 


ANOTHER Listed below is the English description of a 
CHALLENGING program that you should try writing and 
PROGRAM running. The three steps below describe the 


three major components of this program. The 
first two steps can each be translated into one 
line of BASIC command that the computer 
understands. Step 3 will require several lines 
of BASIC commands to ensure that the 
computer does what is described. The 
program you write should behave as described 
in the three steps. 


STEP 1: The computer asks you (by 
displaying the message on the TV) whether it 
should list all the numbers between @ and 190 
for you on the screen. 


STEP 2: The computer waits for your answer 
and stores it in the type of container that 
holds words. 


STEP 3: The computer checks your response. 
If you type in the word “YES” it will proceed 
to print the numbers between @ and 106 and if 
you type “NO” the computer will say 
“GOODBYE” to you rather than print the 
numbers. 


Try writing and running this program. 
Remember that very few people ever get a 
program written 180% correct the first 

time. Part of the beauty of programming is 
that it continually allows you to learn from 
your mistakes. We provided several hints in 
the description of the three steps. Read the 
description carefully before you begin. Good 
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luck. Just in case you get stuck, we wrote our 
program to meet the requirements of steps 
1-3. 


CLS 

PRINT “DO YOU WANT ME TO 
LIST ALL THE NUMBERS 
BETWEEN @ AND 199? TELL 
ME YES OR NO.” 

INPUT A$ 


IF A$ = “NO” THEN GOTO 100 
FOR |=@ TO 100 

PRINT | 

NEXT I 

END 

PRINT “GOODBYE” 


We wrote END on line 79 so that if you type 

“YES” and the computer lists all the numbers 
between @ and 19, it will not continue onto 

line 189. The END serves as a 

barrier to stop the computer from continuing 
to line 169. 


What happens if you enter a word other than 
“ves"’ or “‘no”’ in response to the computer’s 
question? 

Type RUN and find out. 


If you just tried this experiment you should 
have found out that the computer lists all the 
numbers from 9-109 anyway, because as it 
stands now the program only checks for the 
presence of the word “no” in the A$ 
container. If any other word is in there, the 
computer still continues to line 4@. Try to 
repair this program. Here is what we suggest. 


MORE 
DECISIONS 


Add, 


35 IF A$ = “YES” THEN GOTO 40 
37 PRINT “YOU DID NOT TELL ME 


YES OR NO, TRY AGAIN.” 
38 GOTO 20 


If you type LIST, your revised program should 
resemble ours. 


5 CLS 

19 PRINT “DO YOU WANT ME TO 
LIST ALL THE NUMBERS 
BETWEEN 9 AND 100? TELL ME 
YES OR NO” 

29 INPUT A$ 

30 IF A$ = “NO” THEN GOTO 100 

35 IF A$ = “YES” THEN GOTO 49 

37 PRINT “YOU DID NOT TELL ME 
YES OR NO, TRY AGAIN.” 

38 GOTO 20 

49 FOR |=@ TO 100 

58 PRINT | 

60 NEXT | 

70 END 

199 PRINT “GOODBYE” 


Now, if you type in any words other than 
“YES” or “NO”, the computer will tell you that 
what you typed is not what it expected and 

will let you keep on trying until you type either 
“YES” or “NO”. 


Your computer is capable of making other 
kinds of decisions, beyond simple IF-THEN 
tests. Here is another one. Enter the following 
program: 
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19 CLS 

26 REM THIS PROGRAM WILL 
GATHER INFORMATION ABOUT 
FAMILIES 

30 PRINT “DO YOU HAVE A 
BROTHER? TYPE YES OR NO.” 

40 INPUT A$ 

50 PRINT “DO YOU HAVE A SISTER? 
TYPE YES OR NO.” 

60 INPUT BS 

70 IF A$ = “YES” AND B$ = “YES” 
THEN PRINT “THEN THERE ARE 
AT LEAST THREE CHILDREN IN 
YOUR FAMILY.” 

80 IF A$ = “YES” OR B$ = “YES” 
THEN PRINT “THERE ARE AT 
LEAST TWO CHILDREN IN YOUR 
FAMILY’ 

90 IF AS< > “YES” AND B$ = “YES” 
THEN PRINT “AREN’T YOU 
LUCKY THAT YOU DO NOT HAVE 
ANY BROTHERS.” 

100 IF AS = “YES” AND B$< > “YES” 
THEN PRINT “AREN'T YOU 
LUCKY THAT YOU DO NOT HAVE 
ANY SISTERS.” 

110 IF A$ < > “YES” AND B$ < > 
“YES” THEN PRINT “YOU ARE 
AN ONLY CHILD.” 

120 END 


Now RUN 


and answer the questions. If you typed the 
program in Capital Letters make sure that 
when you respond to the question mark sign 
you type the words “YES” or “NO” in capital 
letters. If you typed the program in Lower 
case your ‘‘yes’’ or ‘‘no” response should also 
be typed in Lower case letters. Then RUN the 
program and again type in different responses 
to see the results. 


PRINT IT THE 
WAY YOU WANT 


The program is very straightforward, The new 
commands AND, OR, < > (not equal) are 
used in BASIC the same way they are used in 
everyday speech. 


We can have the PRINT command place 
information on different parts of the screen by 
adding a comma or semicolon to the word 
PRINT. Enter the following program. 


10 FOR |= TO 100 


20 PRINT “HELLO” 
30 NEXT I 


Type RUN. You should recognize this form of 
the PRINT statement. This is what we 
introduced to you a few chapters ago. Now 
change line 20 to read 


10 FOR | = @ TO 100 
20 PRINT “HELLO”, 
30 NEXT | 


Now type RUN again and compare the results 
you get with those of the previous program. 


Now change line 20 again as follows; 


19 FOR |= TO 100 


20 PRINT “HELLO”; 
30 NEXT | 


TAB 


There are three very distinct ways that output 
can be displayed. Later on, we will apply 
these different PRINT styles in our programs. 


By using the TAB command, you can tell the 
computer where you want the information 
to be put. Enter the following lines in 
immediate mode (without a line number). 


PRINT TAB (20); “HELLO” 


and now enter, 


PRINT TAB (30); “GOODBYE” 


TAB starts the printing of the message at the 
column of text specified in the parentheses. 
The left most column of the text screen is J, 
and the right most column is 39. 


SOME “RANDOM” 
THOUGHTS 
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SOME “RANDOM” 
THOUGHTS 


Many games that people play involve an 
element of chance, from board games like 
monopoly to the game of craps played in 
casinos. The excitement and the high risk 
involved in these games occurs by rolling disc 
and getting a random, or unexpected 
number. 


It is very easy for us to roll the dice and 
receive a random number. A random number 
is one that occurs as if you placed your hand 
in a barrel full of numbers and picked one out. 
Unless you were a prophet, you wouldn't 
know what number to expect, and would be 
surprised at the result. 


Random numbers While it is easy for us to roll random numbers 
are important in with dice, it is not so easy for your computer 
computer programs to simulate dice and pick a truly random 
especially in game or number. Many microcomputers don’t even 
quiz programs, as afford you the opportunity to easily spin a 
well as some truly random number. When you tell these 
mathematic and other machines to pick a random number they 
scientific will produce a fake random number. Their 
applications. numbers are not truly random because each 


time they start picking a number they always 
begin with the same number. It’s as if the 
barrel that they picked from only had one 
number in it. 


However, your SV1-728 can pick truly random 
numbers. To do so, always insert the 
following line at the beginning of a program 
that calls for random numbers. 


I 


5 N=RND(-— TIME) 


RND, INT The new commands that are introduced are 
and—TIME INT, RND and - TIME. 


To pick a truly random number the SV1-728 
takes a look at its internal clock, which 
measures the passage of time in 

microseconds. Each time that the computer 
receives the instruction — TIME, it looks at its 
internal clock and uses the time on the clock 
as the truly random number from which to 
pick more random numbers. Since time never 
stands still, each time the computer checks its 
clock it will report a truly random number. 


Type the following short program to see how 
to use line 5 in a program and what the INT 
and RND instructions do. 


10 REM THIS PROGRAM PICKS 
A RANDOM NUMBER 


20 N = RND ( — TIME) 
30 X = INT (RND (1) * 10) 
40 PRINT X 


The new line here is line 30. The first 
instruction that the computer responds to on 
this line is RND (1). The number one in 
parentheses is called a dummy variable 
(container). Any number could have been 
used in the parentheses. In each case the 
computer picks a truly random number that is 
between zero and one, for example, .2345. 
The next instruction that the computer 
performs on line 3 is multiplying the decimal 
number (.2345) by 10. Since we want a whole 
number (one that doesn’t have any numbers 
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to the right of the decimal point) we then use 
the INT instruction to chop off the numbers to 
the right of the decimal point leaving us with 
X=2. 


We can now present the program that 
simulates the spinning of dice to achieve truly 
random numbers. 


19 REMTHIS PROGRAM SIMULATES 
THE ROLLING OF DICE 

20 N = RND ( — TIME) 

30 X = INT (RND (1) * 6 + 1) 


35 IF X = 7 THEN GOTO 30 
49 Y = INT (RND (1) * 6 + 1) 
45 IF Y = 7 THEN GOTO 40 
50 R=X+Y 
69 PRINT R 


Lines 30 and 4@ pick the random numbers. 
Let's take an example. If the instruction RND 
(1) picks the number.9678, we then multiply 
this number by 6 and get 5.8068. The 
computer then adds 1 to 5.8068 and gets 
6.8968. Finally it takes the INT of 6.8968 
which is 6. So “’X”’ dice spun a 6. The 
computer then repeats this process to get the 
number of the “’Y”’ dice and then adds the 
"xX" and “Y" die together and places the total 
in container ‘‘R"’ which is then printed. In all 
honesty, the explanation of random numbers 
is a little complicated and we suggest that you 
review the material a second time if you are 
not quite sure how the RND function works. 


JUMPING The command GOTO was shown to cause the 

AROUND computer to jump from one line to another. 
Right now we will show you another way of 
jumping around in your program and then 
explain the difference between these two 
methods. 


Enter the following program: 


a ee re eee ae eee oe a 


GOSUB/ 
RETURN 


18 REM THIS PROGRAM 
CONVERTS YEARS TO MONTHS 
26 CLS 
30 PRINT “HOW MANY YEARS OLD 
40 INPUT N 
50 GOSUB 200 
69 PRINT “HOW MANY YEARS OLD 
1S YOUR FATHER?” 
70 INPUT N 
88 GOSUB 200 
99 PRINT “HOW MANY YEARS OLD 
IS YOUR MOTHER?” 
100 INPUT N 
118 GOSUB 200 
126 END 
200 PRINT N; “YEARS IS EQUAL TO”; 
N * 12; “MONTHS” 
218 RETURN 


RUN the program and answer the questions. 
Do you understand how this program works? 
Let’s review it. 


After asking you the question on line 30 and 
accepting your answer on line 4G, the 

computer encounters GOSUB 209, which 

means GOSUB subroutine 200. A subroutine is a 
section of a program, either one line or several 
lines, that is referred to frequently by the main 
part of the program. Therefore, it is called a 
SUBroutine, since it is subordinate, or 
secondary, to the bulk of the program. 


When the computer sees GOSUB 209 on line 
59, the computer jumps to line 209. When the 
computer completes the conversion of years 
to months on line 200 and prints it on the 
screen, the program continues to line 219. 
There, the command RETURN sends the 
computer back to the line that follows the one 
which contained the GOSUB 299. In our 


program above, that would RETURN the 
computer to line 66. 


The same thing happens when GOSUB 209 is 
encountered on line 88 and line 119. That is, 
the computer RETURNs to line 98 and 120 
respectively. 


What is the difference between the GOTO 
command and the GOSUB-RETURN 
command? If we had used the command 
GOTO 2090 instead of GOSUB 209, then line 
219 would have had to say GOTO 60 to have 
the computer continue from where it stopped 
when it jumped to 200. But line 219 would 
have also had to say GOTO 99 and GOTO 129 
if we had used GOTO 209 on lines 8@ and 119. 
But the computer could not have understood 
a line 219 that would have said, 


219 GOTO 69, GOTO 99, GOTO 129 


This problem stems from the fact that when 
the computer listens to a GOTO command it 
does not remember the line that it stopped at 
before it jumped to the specified GOTO line 
number. On the other hand, the beauty of the 
GOSUB-RETURN command is that it 
remembers precisely the point from which it 
jumped. When it is finished with the 
subroutine and sees the command RETURN, 
it knows exactly where to return to without 
being told again. 


The next program employs another command 
that is a variation of the GOSUB-RETURN 
statement. Enter, 


THE COMPUTER 
ASA 
CALCULATOR 


19 REM THIS PROGRAM 
DEMONSTRATES A SIMPLE 
TELEPHONE BOOK HELPER 

30 PRINT “IF YOU WANT TO FINDA 
PHONE NUMBER QUICKLY, JUST 
PICK ONE OF THE CHOICES 
BELOW AND | WILL DO THE 
REST’ 

49 PRINT “1. DOCTOR” 

50 PRINT “2. POLICE” 

69 PRINT “3. SPECTRAVIDEO” 

70 INPUT N 

80 ON N GOSUB 100, 200, 300 

99 GOTO 10 

196 PRINT “THE DOCTOR'S NUMBER 
IS 555-1234” 

118 RETURN 

200 PRINT “THE POLICE’S NUMBER 
IS 555-1245” 

219 RETURN 

300 PRINT “SPECTRAVIDEO’S 
NUMBER IS 555-1256” 

310 RETURN 


RUN the program and try it out. The variation 
of GOSUB-RETURN is on line 88. The 
command ON N GOSUB 199, 200, 300 means 
that if ‘‘N”’ (the container that is holding the 
number you have chosen) is the number 1, 
then the computer will jump to the subroutine 
on line 190. If ““N” is holding the number 2, 
then the program jumps to the subroutine on 
line 20@, and if “‘N" is holding the number 3, it 
jumps to the subroutine on line 309. 


You can make the computer function as a 
calculator. 


For addition enter 
PRINT6+3 


ARITHMETIC 
OPERATIONS 


and the computer will output 
9 

For subtraction enter 
PRINT 6 —3 

and the computer will output 
3 

For multiplication enter 
PRINT6*3 

and the computer will output 
18 

For division enter 
PRINT 6/3 

and the computer will output 
2 


If you forget to use the word PRINT when you 
use the computer as a calculator, the 

computer will not output the answer. The 
computer will have calculated the answer and 
placed it into a container in its memory 
automatically, but it will not inform you of its 
answer. 


Most of you probably remember the basic 
rules of arithmetic from your elementary 
school days, so we will not dwell upon these 
types of calculations any further. 


The following table lists the order of 
precedence for the mathematical and logical 
commands that your computer will calculate. 
That means if any of these signs or words 

are used in your programs, the order listed 
here is the order in which they will be 
executed 


( 
N 
* 
+ 
> < = >= <= 2 
A 
O 


NOCPWN= 


PROCESSING 
INFORMATION 


If there is more than one operation listed on 
any line of BASIC commands, and these 
operations are both listed on the same level in 
the above table, then the operation closer to 
the left side of the screen will be performed 
first. For example, if you entered 


PRINT 3+2—1 


the computer will output, 

4 

because it first added 3 + 2 and then did 5 — 1. 
Similarly, if you entered, 

PRINT 3—2+1 


the computer will output, 

2 

because it first perform 3 — 2 and then did 
1+1, 


At the beginning of this tutorial we described 
a computer program as a set of instructions 
that processed (acted on) information. The 
information of the program needs to begin 
processing is called the input to the program 
and the result of the processing is called the 
output. 


The following program demonstrates how to 
tell the computer the information you want it 
to process. Most of the commands in BASIC, 
like PRINT, FOR-NEXT, IF-THEN, PSET, etc. 
tell the computer what to do with information. 
We have already shown you some words that 
tell the computer what information to work 
on commands like INPUT and LET X = 20. 
Now we will introduce you to a new set of 
words, READ and DATA, which as the names 
imply, tell the computer that what follows is 
the information to be processed. 


Enter the following program. 


5 CLS 
18 REM THE FOLLOWING PROGRAM 
WILL READ AND PRINT THE 
NAMES OF THE FIRST FIVE 
MONTHS OF THE YEAR 


20 FOR X=1TO5 

3@ READ F$ 

49 PRINT FS 

50 NEXT X 

68 DATA JANUARY, FEBRUARY, 
MARCH, APRIL, MAY 


Type RUN. 


Your program should have output the names 
of the first five months of the year. Now let’s 
take a closer look and see how the program 
works. 


READ/DATA Line 20 prepares a loop that will do something 
5 times. That something is told to the 
computer in line 38, where we instruct the 
computer to READ some information and 
place it in container F$. When the computer 
comes across the READ command, it 
immediately searches the whole program for 
the first line that begins with the command 
DATA. Since DATA appears on line 69, the 
computer READs the first word, ‘‘January 
and places it in container F$. Then the 
program continues to line 48 and PRINTs the 
word in FS (January). NEXT X on line 50 
sends the computer back to line 26 to begin 
this process of READing and PRINTing again. 


The second time around, the computer looks 
again for the DATA statement that tells the 
computer that on this line it will find the 
information it needs to READ. So the 
computer goes to the information listed on the 
DATA line after the place where it previously 
stopped and stores in F$. When the computer 
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puts the word “February” into container F$, it 
first erases the word ‘January’, which was 
previously stored in F$ . So when the 
instruction PRINT F$ is encountered on line 
40, the only word in F$ is “February” and so it 
is PRINTed on the TV. 


The line that begins with the command 
DATA and contains the information we want 
the computer to READ, can be placed 
anywhere in the program. The READ 
command searches the whole program, 
starting at the beginning, for the first line in 
which the command DATA appears. 
Therefore, our READ/DATA program could 
have been written in the following way: 


5CLS 

16 REM THE FOLLOWING PROGRAM 
WILL READ AND PRINT THE 
NAMES OF THE FIRST FIVE 
MONTHS OF THE YEAR. 

15 DATA JANUARY, FEBRUARY, 
MARCH, APRIL, MAY 

26 FOR X =1TO5 

30 READ F$ 

40 PRINT F$ 

50 NEXT X 


2 DATA JANUARY, FEBRUARY, 
MARCH, APRIL, MAY 
5 CLS 
10 REM THE FOLLOWING PROGRAM 
WILL READ AND PRINT THE 
NAMES OF THE FIRST FIVE 
MONTHS OF THE YEAR 
20 FOR X=1TO5 
30 READ F$ 
49 PRINT FS 
50 NEXT X 


The information that is placed on the DATA 
line is separated by commas. The words or 
numbers between commas are treated as one 
piece of information. Enter and RUN the 
following program to see what we mean. 


10 CLS 

26 REM THIS PROGRAM READS 
AND PRINTS OUT THE NAMES 
OF FIVE STATES 

30 FOR X=1TOS5 


49 READ F$ 

58 PRINT FS 

60 NEXT X 

78 DATA NEW YORK, NEW JERSEY, 
NORTH DAKOTA, NEW 
HAMPSHIRE, NEW MEXICO 


How does the following program, which reads 
and prints the name of 5 states, differ from 
the program that did the same thing above? 


10 CLS 

20 FOR X=1TO5 

30 READ F$: READ G$ 
49 PRINT F$, G$ 


50 NEXT X 

60 DATA NEW, YORK, NEW, JERSEY, 
NORTH, DAKOTA, NEW, 
HAMPSHIRE, NEW, MEXICO 


You should be able to tell the difference from 
just comparing the two programs without 
even having to enter the second version and 
running it. 


The first program, which read and printed the 
names of 5 states, did so by reading each set 
of two words into one container, F$. In the 
second program, the name of each state was 
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OUT OF 
DATA 
message 


CLEAR 


broken into two parts. The first half of the 
name was stored in container F$ and the 
second half of the name was stored in 
container G$. 


Enter the above revised program into the two 
containers F$ and G$, if you have not yet 
done so. Run the program. Now add line 7@: 
79 GOTO 26 

And RUN the program again. Did you get 
OUT OF DATA message? That error message 
resulted form the fact that you tried to 
READ information again but since the 
computer finished READing the list after you 
ran the program the first time, the computer 
did not find any more information on the 
DATA line after the name MEXICO. 

The way to fix that problem is to tell the 
computer to return to the beginning of the 
DATA before it is time to read the names 
again. The command you use to do this is 
RESTORE. Here is how the repaired program 
looks. 


19 CLS 

20 CLEAR 500 

30 FOR X=1TO5 

40 READ F$: READ G$ 
50 PRINT F$, G$ 


69 NEXT X 

78 RESTORE 

88 GOTO 36 

98 DATA NEW, YORK, NEW, JERSEY, 
NORTH, DAKOTA, NEW, 
HAMPSHIRE, NEW, MEXICO 


Here is how this program works. We have 
added another command called CLEAR on 
line 20. Whenever you use a READ-DATA 
command you should also use CLEAR, which 
CLEARs away a lot of room (e.g., 50 spaces) 
in the computer’s memory. Then you can 


RESTORE 


ANOTHER TIME 
SAVER 


AUTO 


work with the containers that store words 
without running out of space, because the 
containers that store words and text generally 
take up much more room than the containers 
that store only numbers. 


Then on line 76, the RESTORE command 
instructs the computer to return to the 
beginning of the list of information on the 
DATA line before the GOTO 39 command on 
line 8@ sends the computer back to the 
beginning of the loop on line 30. The program 
should print out the names of the states 
without receiving am OUT OF DATA message. 


Our programs are beginning to get larger. 

That is we are writing more lines of 
instructions in each program. Some people 

like to tell the computer to automatically write 
the line number for each line of the program. 
This is accomplished by typing: 


AUTO 


In immediate mode, the computer will 
respond with the number 19 and it will wait 
for you to begin typing on line 19. When you 
have finished line 19 and pressed 
the computer will automatically print line 26 
and wait for you to continue. 


You can make the computer start the 
automatic line numbers from a number other 
than 10, and it can increase the number for 
the next line by more than or less than 19. In 
other words, the AUTO command can be told 
what line number to start with and the increase 
for each subsequent line. 

For example: 

AUTO 2G, 49 

This will start the first line number at 20 and 
cause the second line number to be 69 and 
the third line number to be 100. 
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As with all the commands we have introduced 
to you in this tutorial guide, it is necessary for 
you to read the material in other parts of this 
manual to get a full understanding of each 
BASIC command. 


ARRAYS-A WAY OF 
ORGANIZING MANY 
CONTAINERS 
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ARRAYS-A WAY OF 
ORGANIZING MANY 
CONTAINERS 


We hope that you are beginning to feel 
comfortable with the concept of containers 
and how your computer uses them to store 
and manipulate information. Previously, we 
have always used a container as an individual 
unit. That is, we have thought of each 
container as a distinct unit. “A”, “B”, “C$” 
and ‘‘D$" are examples of individual 
containers into which we put numbers and 
words. However, we did not have the need to 
group several individual containers into one set. 


There are times when it is necessary to 
arrange a series of containers into a larger 
unit. If you wanted to keep track of 5 test 
scores for each of the 25 students in your 
class, it would make sense to organize the 
containers that hold the scores into a larger 
unit. Then you work with 25 sets of 
containers, rather than with 125 individual 
containers. (Each set would be a table with 5 
lines of information.) Here is an example of 
what the table for a student named John 
might look like. 


JOHN 


(1) 75 
(2) 82 
(3) 94 
(4) 68 
(5) 109 


Thus if we had before us 25 different tables 
representing the scores of all 25 students, we 


ASE SSE APOE PEL TTS 


118 


DIM 


could then refer to John’s first test score as 
John (1), his second test score as John (2) 
etc. 


The following program demonstrates how we 
can instruct the computer to group John’s 5 
test scores into a table. 


18 REM THIS PROGRAM 
ORGANIZES JOHN’S TEST 
SCORES INTO A TABLE 

20 CLS 

30 DIM J (5) 

40 FOR X=1TO5 


50 READ J (X) 
60 NEXT X 
70 PRINT “WHICH TEST GRADE DO 
YOU WANT?” 
80 INPUT Z 
99 PRINT J (Z) 
100 DATA 75, 98, 94, 68, 100 


« 


Enter this program and RUN it. This is how it 
works, 


Line 36 DIMensions a block of five containers 
for the set of containers called J’. That 
means the computer is instructed to set aside 
enough room to store 5 numbers in 5 different 
containers. “J is the name for this group of 
containers. On line 5@ the computer READs in 
one test score at a time from the data line and 
places it into one container. 


When the program reaches line 7, it has 
already placed all 5 test grades into 5 different 
containers. This information is organized in 
the computer in a way that is similar to the 
table of John’s test scores. So when we 
INPUT the test score that we want in line 8@, 
the computer is told on line 9@ to print that 
Particular line of the table. 


WORKING WITHA 
LARGER SET OF 
CONTAINERS 


Oh, we almost forgot to tell you: The offical 
computer term for the set of containers that 
we just worked with is an “array”. 


It is a little trickier to work with a large set of 
containers that can store two items each than 
it is to work with the simple container we 
demonstrated above. If you wished to store 
the scores of 5 students for one test, you 
would need to have one set of containers that 
stores their names, and one that stores their 
respective grades. The table that represents 
this information looks like this: 


TEST #1 


(1) JOHN 75 
{2)BOB 81 


(3) JOAN 65 
(4) HARRY 96 
(5) LINDA 98 


Figure 7 

The program that wit READ and PRINT out a 
table just like the one in Figure 7 is listed 
below. Enter the program, RUN it and try to 
understand it before reading our explanation. 
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19 REM THIS PROGRAM 
ORGANIZES NAMES AND 
SCORES FOR ONE TEST 

20 CLS 

39 DIM V$ (5,2) 

49 FORN=1TO5 

50 FORS=1TO2 

60 READ V$ (N,S) 

70 NEXT S: NEXT N 

89 REM THIS SECTION PRINTS OUT 
THE TABLE 

96 PRINT “NAME”, “GRADE” : 
PRINT 

199 FORN=1TO5 
119 PRINT V$ (N, 1), V$ (N, 2) 
120 NEXT N 
139 DATA JOHN, 75, BOB, 81, 
JOAN, 65, HARRY, 96, LINDA, 98 


Don’t get discouraged. This is the most 
difficult program you will see in this tutorial! 
Let’s take a closer look at it. 


Line 39 DiMensions or sets aside 5 containers 
that will store the number corresponding to 
the student’s names listed in Figure 7, and 
the 2 containers that correspond to each 
name or number. 


Lines 100-126 PRINT the table on the TV 
screen in the same form as appears in 
Figure 7. 


The computerese term for this extended 
container is a ‘double array”, which is a 
fancy way of describing a two-column table. 


Is there another way that we could have 
written this program? Yes, there is. Generally, 
almost all programs can be written in more 
than one way. Different people plan and 
program according to their own styles. Of 
course there are important differences among 


the various styles. You will learn to discern 
which option to choose as your knowledge 
increases with practice. 


Here is another way you could have written 
the program that reads and prints the table in 
Figure 7. This time we use two separate sets 
of containers: One to store the names, and 
one to store the grades. Each one uses a non- 
column array, not the double column array 
that we just used. 


18 CLS 

28 DIM A$ (5), B (5) 
38 FOR|1=1TO5 
40 READ A$ (1), B (I) 
50 NEXT I 


60 PRINT “NAME”, “GRADE”: PRINT 
70 FOR K=1TO5 
80 PRINT A$ (K), B (K) 
98 NEXT K 
108 DATA JOHN, 75, BOB, 81, JOAN, 
65, HARRY, 96, LINDA, 98 


RUN the revised program to make sure that it 
does what it is supposed to. 
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ON THE END OFA 
LONG STRING 


123 


124 


ON THE END OFA 
LONG STRING 


STRING Congratulations! You have made it this far 
and we trust you are doing well. We will now 
cover what is known in computerese as 
“String Manipulations”. A string is a group of 
characters that usually is just a word. 
Accordingly, a word is considered to be a 
string of characters that can easily be changed 
and rearranged. 


Enter the following program. 


18 CLEAR 2008 

20 INPUT “TYPE IN A SENTENCE 
THAT IS NO MORE THAN 106 
WORDS LONG.” ; S$ 


36 PRINT “THIS IS THE NUMBER OF 
CHARACTERS IN THE SENTENCE 
THAT YOU JUST TYPED.” 

40 PRINT LEN (S$) 


Now RUN the program. As its name implies, 
the LEN command calculates the number of 
characters in a string of characters. In this 
example, the whole sentence was stored in 
container S$. 


INPUT We hope you have noticed that line 20 looks a 
bit unusual. This is because we used the 
INPUT command to print the message on the 
screen without the help of the PRINT 
command, and placed the container name at 
the end of the line. This line is a very good 
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example of a short cut in programming that 
combines several commands on one line. 


LEFT$ The following commands manipulate 

RIGHTS character strings in various ways; RIGHTS, 

MIDS LEFT$ and MIDS. The programs below will 
introduce these commands and their use to 
you. 


10 INPUT “TYPE A WORD THAT IS AT 
LEAST 6 LETTERS LONG”; W$ 
20 PRINT “THE FIRST LETTER IS:”; 


LEFTS$ (W$,1) 

30 PRINT “THE LAST TWO LETTERS 
ARE:”; RIGHTS (W$,2) 

49 GOTO 10 


The LEFTS$ (W$,1) command on line 20 told 
the computer to print the first character to the 
left of the string of characters stored in 
container WS. If we had written LEFT$ (W$,3) 
then the computer would have printed the 3 
characters closest to the left. 


Similarly, the instruction RIGHT$ (W$,2) on 
line 38 causes the computer to print the 2 
characters to the right, or the end of the string 
of characters to the right, or the end of the 
string of characters that is stored in container 
ws. 


The MID$ is more powerful than the LEFT$ 


and RIGHTS commands. Enter and run the 
following program. 


10 W$ = “SPECTRAVIDEO” 


20 PRINT MID$ (W$S,4,3) 


This MID$ command on line 20 started at the 
fourth character from the left of the word 
SPECTRAVIDEO (which was stored in container 


W$), and counted the next three characters 
and printed out these characters, i.e., CTR. 


But the MID$ command can also serve a very 
useful function. 


If you wanted to search through a sentence 
for a specific word, you could use MIDS. It is 
demonstrated in the following program. Enter 
and run the program. 


19 CLEAR 500 

20 INPUT “TYPE A SENTENCE THAT 
IS NO MORE THAN 10 WORDS 
LONG”; S$ 

30 INPUT “TYPE A WORD THAT 
APPEARS IN THE SENTENCE 
YOU ENTERED”; W$ 

40 X = LEN (W$) 

50 FOR T = 1 TOLEN (S$) 

60 IF MID$ (S$,T,X) = W$ THEN 
GOTO 100 

76 NEXT T 

80 PRINT “THE WORD YOU 
SEARCHED FOR IS NOT IN THE 
SENTENCE” 

99 END 

190 PRINT W$ “APPEARS IN THE 

SENTENCE AT CHARACTER 
NUMBER “:T 


In this program, MID$ is used to test various 
sized groups of characters to see if they are 
identical to the word we are searching for. 

LEN The program calculated the LENgth of W$, 
and placed the number of characters in W$, 
into the container called “X” (line 406). Then 
the computer starts at the left position of the 
characters in W$ and counts the number of 
characters stored in ““X"’. If a match is found, 
you are told that the word has been found in 
your sentence. 
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ADVANCED 
GRAPHICS 

AND SOUND 
PROGRAMMING 


The material in this chapter will demonstrate 
the advanced graphics and sound capability 
that is built into the SV1-728 which separate it 
from its competitors. This power is not 
available and accessable from BASIC in any 
other personal computer. 

This chapter is separated into two parts. The 
first part expands on the introduction to 
graphics that you have received earlier. The second 
part explains the simple approach to sound 
programming using the PLAY command. A 
more complicated approach to sound 
programming is possible using the SOUND 
command which is explained in Appendix H. 
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PART ONE-— 
ADVANCED 
GRAPHICS 


To begin exploring the graphics capability of 
the SV1I-728, type in the following lines, 
pressing ENTER after each is completed: 


10 SCREEN 2 
20 CIRCLE (128,80),60,11 


30 PAINT (128,80),11 
49 GOTO 30 


Now, RUN the program and you will see the 
yellow circle appear on the screen and then it 
will be filled in by the SVI-728’s yellow 
Paintbrush. To understand how this happens, 
let’s look at each line individually. 


This line causes the computer to display its 
graphic screen. 


20 CIRCLE (128,80),60,11 


Here, you are telling the computer to draw a 

circle around a center point that is 128 columns 
from the left side of the screen, 80 rows down 
from the top of the screen, with a radius 

(distance from the center of the circle) of 60 
points and using the yellow (the number 11) 
outline. 
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PAINT 30 PAINT (128,80),11 


This line introduces you the PAINT 

command. This command tells the computer 

to use its “paint brush” to fill certain areas. In 
line 38 the computer is instructed to fill the 
circle you have just outlined in line 2@. In order 
to paint (fill) an object you must give the 
computer the coordinates numbers (in 
parentheses) which designate any point inside 
the object (as we just did giving the 

coordinates of the center point of our circle), If 
you had used coordinates which designate a 
point outside the object, the computer would 
have painted the whole background but not fill 
the object itself. 

However, the fill color MUST be the same 

as the outline colour. In our case the number 11 
is the same yellow color used for the circle 
outline from line 26. The PAINT “‘recognizes”’ 
outlines of objects as borders only if their color 
matches the PAINT color. A different PAINT 
color will “‘ignore’’ the outlines and will paint 
(fill) the whole screen-covering the object. 


49 GOTO 30 


The last line of this program causes the 
computer to repeat line 3@ so the circle will not 
disappear. To stop the program press the 
CTRL-STOP keys combination. 


You can experiment with the numbers in this 
program to vary the location, size or color of 
the circle being painted. 


You can create a vast array of different sized 
circles and geometric shapes by adding a few 
more instructions to the CIRCLE command. 
We will give you another example of using the 
circle command. 


—————E es | 32 
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Change the program to read: 


18 SCREEN 2 


20 CIRCLE (128,96),80,13,3.14,6.28 
38 GOTO 36 


RUNning the program will give you the following 
result: 


You should see the bottom half of the circle. 
Should you change line 29 to be: 


26 CIRCLE (128,96),80,13,6.28,3.14 


you will see that the top half of the circle is 
drawn. Another way of constructing a whole 
circle is with the following changes in line 29: 


20 CIRCLE (128,96), 80,13,0,6.28 


Those of you who remember your geometry 
will recall that 3.14 is pi and 6.28 is 2pi 
(approximate). The two pi numbers which 
follow the color number (#13) on line 2@ tell 
the computer where you would like the 
computer to begin and end the circle (how 
much of the circle you want drawn). 


You can also specify the kind of shape drawn. 
For example, you can draw an ellipse (a 
distorted circle for those of you unfamiliar 
with geometry) with the following added 
feature on line 20. 


26 CIRCLE (128,96), 80, 13,,,1/4 
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How did we get an ellipse? Well, the three 
commas after the number 13 are necessary to 
inform the computer that we will not be 
specifying the starting and ending points of 
the shape and are therefore leaving them 
blank. The computer knows what to do when 
we leave it blank. It assumes that we want the 
whole shape drawn. The 1/4 at the end of line 
26 tells the computer the height/width ratio 
that we want. 


Generally, the width of the circle is the same 

as the diameter you specify. However, if the ratio 
number at the end of the CIRCLE command 

line is less than one (1), the circle will be wider 
than it is high, as in the example above where 

the ratio is ‘’1/4’’. If the ratio is greater than 

one (1), the circle will be higher than it is 

wide, as in the following example: 


29 CIRCLE (128,96), 80,13,,,2 


LINE 


S| 


Now that you have seen what your SV1-728 can 
do with circles and its paintbrush, we'll take a 
look at lines and boxes. The computer has the 
same simple method for drawing them as it 
does for circles. First, type NEW to clear the 
memory of the program we were using before. 
Now, enter the following 


10 SCREEN 2 


26 LINE (50,48) — (200,150),14 
30 GOTO 30 
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When you run this program, you will see that a 
line has been drawn from high on the left side 
of the screen to a low point on the right side of 
the screen. The line that causes this to happen 
is line 2Q: 


30 LINE (50,49) — (200,150),14 


This line tells the computer to draw a line from 
a position 50 points from the left margin on the 
screen and 49 points down from the top over 
to a position that is 260 points from the left 
margin and 150 points down from the top. The 
number 14 designates the color of the line to 


be white. 
BOX By simply adding the letter “B’’ following a 
(B) comma to the end of line 20 you will convert 


this line into a box. 


20 LINE (50,49) — (200,159),14,B 


RUNning the program now, will show a box 
(outlined rectangle) on the screen. The ‘’B” tells 
the computer to draw the box at the same 
coordinates as the line. 
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BOX FILL To tell the computer to use the paintbrush 
(BF) (fill the box) simply add the letter “F”’ 
immediately to the right of the “‘B” in line 20: 


20 LINE (59,40) — (200,150),14,BF 


Now, you will see that the program draws the 
same box and paints the inside with the same 
color as the outline. 


As an interesting summary of the graphics 
commands you have learned so far RUN the 
following program: 


16 COLOR, 1,9 
26 SCREEN 2 
30 CIRCLE (126,110),60,9,,,1.3 
40 CIRCLE (110,96),10,2 
50 PAINT (110,96) ,2 
60 CIRCLE (142,96),10,2 
76 PAINT (142,96),2 
80 LINE (100,125) — (105,135),14 
90 LINE (152,135) — (147,135),14 
100 LINE (105,135) — (147,135),14 
110 CIRCLE (74,119),25,11,,,5 
120 CIRCLE (178,110),25,11,,,5 
130 Y = 85:R = 50:C = 1 
140 FOR Q=1TO 10 
150 Y=Y —5:R=R—4:C=C+1 
160 CIRCLE (126,Y),R,C,,,.2 
176 NEXT Q 
180 FOR T = 1 TO 500: NEXT T 
199 N = RND (— TIME) 
200 FOR T=1TO 30 
210 X =X + 10:Y = 100 
220 C = INT (RND(1)*15) + 1 
230 LINE (X,Y) — (X + 35, Y + 35),C,BF 
240 LINE (X,Y) — (X + 35, Y + 35),1,BF 
250 NEXT T 
260 GOTO 260 


This program demonstrates all the concepts 
introduced thus far. We will continue with 
some more graphics commands. 


ES ER 
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DRAW 


The DRAW command is actually the door to 
an actual mini-language within BASIC called 
“Graphic Macro Language (GML)"’. 

Start by clearing the computer’s memory. 
(Type: NEW then press ENTER) 

Then type the following lines: 


10 SCREEN 2 
20 PSET (50,60), 1 


38 DRAW “D590 R50 U50 L50” 
49 GOTO 40 


Line 20 positions your graphic cursor at the 
X, Y coordinates (50,60), and designates the 
color to be black (1). 


Line 30 starts the line drawing at the point 
specified in the PSET command, It can 
moves relative to the point, according to the 
distance and directional commands specified 
in the DRAW statement. 
Example: 

DRAW “U59R59” 


This tells the computer to draw fifty 
units to to RIGHT. 


Instructions are in quotes because the DRAW 
command acts on a character string. Remember, 
a character string is a variable (container) that 
holds characters. Therefore, we could have 
written the DRAW example used above in 

the following manner. 


30 T$ = “U50R50D590L50” 
40 DRAW T$ 


50 GOTO 50 


This second way of DRAWing first defines the 
object we wish to DRAW, and then places it 
in TS and then DRAWs TS. 


Please note you can draw diagonally using 


E = diagonally up & right 

F = diagonally down & right 
G = diagonally down & left 
H = diagonally up & left 


Now we will look at several other additional 
graphic commands you can use to create 
exciting screen displays. They are SCALE, 
LOCATE and BLANK MOVE. 


SCALE Type in and RUN the following program: 


10 COLOR, 1, 1 

20 SCREEN 2: X= 14: Y=120: 
CO=2:2Z=1 

30 PSET (X, Y) 

49 A$="S=Z;C=CO;F15R50E15 
U45H15L30H 15U2G0E 19R20F 10 
R19U12H15L30G20D35F25R25 
F19D18G19L35H19L10D14S0” 


50 DRAW A$ 
60X=X+16:Y=Y+8 

CO=CO+1:Z2=Z+1 
70 IF Z> 10 THEN 20 
90 GOTO 30 


In this example, the variable A$ contains the 
statement S = Z which sets the command 
SCALE equal to Z. As the program 

continues, Z is raised by 1 each time line 60 is 
reached. This causes the scale to be raised by 1. 


LOCATE Now try this program: 


19 COLOR, 1, 1 

11 CLS 

12 REM LOCATE IS USED TO 
POSITION CURSOR 

13 LOCATE 19, 170 : PRINT 
“THIS IS AN” 

14 LOCATE 19, 180 : PRINT 
““EXAMPLE OF LOCATE” 

15 FOR l=1 TO 1000: NEXT 

20 X=14: Y=120:CO=2:Z=1 

25 SCREEN 2 

30 PSET (X, Y) 

49 AS ="S =Z;C = CO;F15R5GE 15U45 
H 15L3QH15U2GE 19R2GE 10R20F 10 
R 19U12H15L30G20D35F25R25 
F19D18G10L35H10L 10D14S0” 

50 DRAW A$ 

60 X=X+16:Y=Y+8:CO=CO+1 
:Z=Z2+1 

70 IF Z>1@ THEN 20 

90 GOTO 30 


The command LOCATE is used to position the 
cursor displayed on the screen. 
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BLANK MOVE Now, type NEW and enter the following 
program: 


19 REM DRAWING 
20 SCREEN 2 
30 A$ = “BM3G,156C9F15R50 E15U 
45H15L30H 15U20E 19R20F 10R 
19U12H15L30G20D35F25R25F 
19D18G190L35H10L10D14” 
49 DRAW A$ 
50 PAINT (42,154),9 
60 LINE (150,171) — (210,171),2 
70 LINE (210,171) — (230,34),2 
80 LINE (230,34) — (210,34),2 
90 LINE (210,34) — (199,151),2 
100 LINE (190,151) — (170,151),2 
110 LINE (170,151) — (150,34),2 
120 LINE (150,34) — (130,34),2 
130 LINE (130,34) — (150,171),2 
149 PAINT (165, 165),2 
150 GOTO 150 


In this example, line 30 contains the statement 
BM30,156. This is the command that causes 
the cursor to begin drawing at those specified 
X and Y coordinates. Without using this 
command, all draw statements will begin 
executing at the upper left corner of the 
screen. 


SPRITE$ Now that we have learned how to deal with 
the simpler shapes, we will examine the more 
complex type of graphics generation called 
SPRITE generation. The best way to 
understand a sprite is to imagine it as a magic 
genie you can create and easily control. 


Unlike the graphic commands we 

have encountered up till now which can only 
create one type of an object, like a line or 
circle — the manipulation of sprites is a lot 
more flexible. 
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In order to see a sprite on the screen you must 
do the following: 


STEP 1: Pick one genie “‘to talk to!” (There are 
32 different genies available to do your 
bidding). 

STEP 2: You must tell the genie “what you 
want it to wear:” In other words, what 
shape you want it to assume). 

STEP 3: You must tell it what color to take 
the shape that it will wear. 

STEP 4: You must tell it where to appear on 
the screen. 


The importance of this genie metaphor cannot 
be overstated. Whenever you do not get the 
results you expected when commanding a 
genie it is probably because you did not 
provide all four pieces of information 
necessary to make the genie appear. 


We will now demonstrate how to instruct a 
genie. Enter the following program and RUN 
it. 


10 SCREEN 2 
20 FORT=1TO8 
39 READ A$ 
40 S$ = S$ + CHRS$(VAL("&B” + A$)) 
50 NEXT T 
60 SPRITES (1) = S$ 
76 PUT SPRITE 9, (128,96),8, 1: 
GOTO 70 
109 DATA 00011000 
110 DATA 00111190 
120 DATA 61111110 
130 DATA 61111110 
149 DATA 01111110 
150 DATA 61111110 
169 DATA 00111100 
179 DATA 00011000 


You should see a red ball appear at the center 
of the screen. This ball is the sprite that we 
created in the above program. Here is how it 
works. 


Lines 196—17@: These lines design the clothes 
that the genie will wear (or in straighter 
language, they contain the design of the 
sprite’s shape). Each line of the data 
statement has eight characters on it. They 
represent the size of the sprite. The zeros are 
to make the display transparent at that point 
of the shape while the ones are the points of 
the display that are lit. 
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If we took an 8 by 8 grid , the shape 
would look like this: 


Lines 20—5@: These lines complete the design 
of the shape of the clothes. They set up a 

loop that will read the set of data lines, convert 
them into binary strings, append each one to 
the former and then store this one shape unit 
in S$. 


Line 6@: This line picks the sprite that we will 
command (#1) and tells it to carry the shape 
contained in S$. 


Line 7@: This line tells the sprite what color to 
make the shape, and where to appear on the 
screen. This line: 


| 7@ PUT SPRITE @, (128,96), 8,1 | 


is read like this (It’s a long sentence, but you'll 
be able to follow it): 


PUT the SPRITE that is specified at the end of 
line, which is #1, on plane (surface) 9, at 
position (128,96) which is the center of the 
screen, using color #8. The sprite to use is #1. 


(Note: In the command, PUT SPRITE 

(sprite plane), (X,Y), (color #), (sprite 
pattern #), the use of different plane numbers 
allows the user to place more than one sprite 
on the screen at once.) 


The way we create sprites is very logical. If 
you are familiar with any other computer’s 
BASIC, you will immediately notice how 
much easier the sprite manipulation is on the 
SVI-728. That’s because other systems force 
you to go PEEKing and POKing around 
their computer's memory. 


Sprites are not limited to only 8 by 8 pixels. 
Sprites can also be placed within a 16 by 16 
box. The sprite size after the screen mode 
determines the size of sprite. The sprite size 
should be set to @ to select 8 X 8 pixels, 1 to 
select 8 X 8 pixels (magnifed by 2), 2 to 
select 16 X 16 pixels, 3 to select 16 X 16 
pixels (magnified by 2). 


Hence, if sprite size 1 is selected the sprite 
becomes 8 X 8 pixels (magnified by 2); 
however, if sprite size 2 is selected, then the 
use of a 16 X 16 box is allowed. But, the 
computer fills the 16 X 16 box differently than 
it fills the 8 X 8 box. The following program 
should illustrate how this works: 


1@ screen 2, 2 

20 for X =1 to 32 

30 read a$ 

49 restore 

50 s$ = s$ + chr$ (val(’‘&b” + a$)) 


69 sprite$ (0) = s$ 

70 put sprite G, (128, 96), 1,0 
80 next x 

90 goto 90 

100 data 11111111 


eR RC NRT 
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Notice tha the computer first fills a box 8 x 16 
and then fills another 8 x 16 box 

alongside this one to make 16 x 16 box. 
Therefore, when making a 16 x 16 sprite, 
careful manipulation of data statements (32 of 
them) is required. 

This program demonstrates the use of the 
joystick to move sprites. When run, a small 
spaceship-like sprite will appear. This sprite 
can be moved anywhere within the confines 
of the screen and will also fire a bullet when 
the trigger is pressed. 


1@ Color 15, 1,1 
20 Screen 2,2 
30 Rem This section reads in the sprites 
40 ForT=1to8 
50 Read A$ 
60 S$ =S$ + CHRS(VAL (“&b” + A$)) 
70 Next T 
80 SPRITE $ (1) =S$ 
90 For T=1to8 
100 Read BS 
110 U$ = U$ + CHRS (VAL(’&b”’ + BS)) 
120 Next T 
130 SPRITE $ (2) = US 
149 Rem This section sets the initial 
location of the Sprite 
150 X=128: Y =96 
16@ Put SPRITE 1, (X,Y), 9,1 
170 D=STICK (@) 
180 F =STICK (@) 
199 Rem This section takes the given 
joystick information and uses it 
to make the sprite move 
200 If F <> @ then GOSUB 460 
210 IfD=1thenX=X:Y=Y-1 
220 IfD =2 then X=X+1:Y=Y-—1 
230 IfD =3 then X=X+1:Y=Y 
240 IfD =4then X=X+1:Y=Y+1 
250 IfD =5SthenX=X:Y=Y+1 
260 IfD =6 then X=X—1:Y=Y+1 


270 If D=7 then X =X-—1:Y=Y 
280 If D =8 then X=X—1:Y=Y-—1 
299 GOTO 16¢ 

300 DATA 006111100 

310 DATA 01900010 

320 DATA 10000001 

33@ DATA 11111111 

340 DATA 61000010 

350 DATA 10000001 

360 DATA 19000001 

370 DATA 10000001 

386 DATA 00016000 

390 DATA 00101000 

400 DATA 00101000 

419 DATA 00111000 

420 DATA 00000000 

430 DATA 00000000 

440 DATA 60000000 

450 DATA 00000000 

460 For | = Y —3 to — 20step — 2 
47@ Put Sprite@, (X,1),9,2 

480 Next | 

490 Return 


If you have understood all of the previous 
graphics examples and concepts, you should 
be well on your way to creating exciting 
graphics to enhance the programs you create 
using your SV 1-728. 


That ends our introduction to BASIC 
graphics. Now it is time to move on to 

the extraordinary sound capabilities of the 
SV1-728. 
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PART TWO- 
SOUND 
PROGRAMMING 


There is also a very powerful music synthesizer 
built-in to the SV1-728 that is easily used by 
simple BASIC commands to produce music. In 
addition to the power of this synthesizer, it is 
most important to realize that it can do its work 
independently of the main microprocessor. 
What this means is that you can program the 
synthesizer to do one thing while the screen, 
printer, modem or other peripheral is doing 
something else. 


The following figure represents the available 
musical scale that can be accessed by the 
SV1-728's synthesizer. 


PLAY 


O (OCTAVE) 


The command that opens the door to this 
synthesizer is the BASIC keyword PLAY. For 
example, Typing the BASIC statement: 


PLAY “CDE” 


followed by pressing the ENTER key, will 
produce musical tones from your SV1-728 
through the speaker on your television or 
monitor. You could achieve the similar results 
by writing a BASIC program with the following 
lines: 


10 PLAY “CDE” 


20 GOTO 10 


There are numerous other things that can be 
done with sound using the synthesizer in your 
SVI-728. We will look at the simple ones in this 
section and progress to the more complex 

ones in later pages. We will continue to work 
with the BASIC program listed above and 
make changes in it as we go along. 


First, change line 10 to read: 


10 PLAY “O1CDE” 


Now, when you run the program, you will hear 
that the sounds produced are at a very low 
pitch when compared with the first ones you 
made. This is because you have set the 
OCTAVE by adding the “O01” before the 
“CDE”. This is the command that allows you to 
access 8 octaves with the synthesizer. Now 

add this line: 


11 PLAY “O4CDE” 


When the program is run, you will hear three 
low notes followed by three higher notes. The 
octaves you can access using the ““O” 
command can range from 1 (lowest) to 8 
(highest). 
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——————————————————————————————— 
T (TEMPO) Now, change line 19 to read: 


19 PLAY “T3201CDE” 


The program will now play the same note you 
heard before but at a much slower rate. What 
you did by typing the “T32” before the 
“O1CDE” was to set the TEMPO or speed of 
the music. The values for ‘’T’’ can range from 
32 (slowest) to 255 (fastest). 


You will also notice that the notes in line 11 
also play at the slower pace. This is because 
the synthesizer will play at whatever tempo 
you set until you tell it to play at a different 
tempo. To see this in action, change line 11 to 
read: 


11 PLAY “T2550 4CDE” 


| 


Now, as you can hear, the notes from line 11 
play at a much faster pace than those in line 
10. 


L (LENGTH) You can also control the length of each note 
individually. To see this, change line 18 to 


19 PLAY “T25501CDL1E” 


This change the ‘‘E”’ note to a much longer 
duration than “C” or ‘’D” and also causes the 
notes in line 11 to play for a longer time. This 
length command can be placed in front of any 
note to control its length. The length of the 
notes can be varied from 1 (longest) to 64 
(shortest). 


Two other BASIC commands that can be 
applied to sound are the “’S” command and 
the “M” command. These two commands 
determine the tonal qualities of the note being 
played. These are more commonly referred to 
as the “ENVELOPE” characteristics of a note. 
Everything that creates a sound has unique 
characteristics. 
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S (SHAPE ) 


M (TONE) 


R (REST) 


For example: the same note played on a piano 
and a trumpet may be at the same pitch but 
will have two distinctly different sounds. These 
two commands allow you to shape the notes 
you are creating in the same way. 


The “’S” command controls the shape of the 
note. As an illustration of this, change line 10 
to read: 


| 18 PLAY “S104CDE” | 


and eliminate line 11. 


Now, run the program to see the differences in 
the sounds you hear. These shape commands 
can be considered the voices of the 

synthesizer. There are 14 of them built-in to 
the SVI-728. This means that the numbers used 
to set the “S” command can range from 1 to 
14, 


The “M” command controls the tone period or 
to be more specific, the amount of time that 
you will hear each note based on its tonal 
qualities. To see how this works, change line 
1 to read: 


19 PLAY “S19M500004CDE” 


As you will hear, this changes the sound 
dramatically. The values used to set “M’’ can 
range from 1 to 65535. 


You can also insert pause between notes by 
using the ‘“’R” command. Change line 19 to 
read: 


18 PLAY “O4CR1DR10E” 


This causes the ‘’C’’ note to play and then 
silence is heard for a while then the ‘’D” note 
plays, then a shorter period of silence, then the 
“E”' note followed immediately by the “‘C”’ 
note again. 
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V (VOLUME) 


USING 
3 CHANNELS 
OF SOUND 


The final command we will examine in this 
section is the “V” command. This command is 
used to set the volume of the sound being 
produced, Change line 19 to read: 


10 PLAY “O4V5CV1@DV15E” 


You will now hear that each note gets louder 
than the one before it, You can set the volume 
from @ to 15. 


So far, we have only used one note at a time 
to demonstrate the use of the synthesizer. 
However, the SV1-728 has three separate 
channels of sound that can be programmed 
individually to play together to create chords. 
Change line 19 to read: 


19 PLAY “O1CDE”, “O3EFC”, “O5GAB” 


What you hear is three notes being played in 
combination to create a chord. You can also 
have each channel play something entirely 
different from the others to create a melody 
and harmony part in the music you create. 


There are also other ways of addressing the 
sound and music generation capabilities of the 
SV1I-728 and they will be covered in the 
appendix, which is called “USING THE 
PROGRAMMABLE SOUND GENERATOR”. 
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APPENDIX A 


ASCII| CHARACTER CODES 


tel [olshelet al ofc PSSA 
hun] BIR <0}:0 [0] «3/3 | >FO/D] 8] ae [ES 
CO | 4:3 @ [0] 10] 6 [eco | |: |-@|:— |e | Feet 
SELEDEEEERERS Esai 
(o|- | o|.9] of 5] @|+| o-<}--|-)~/—| €| €| 0} 
wo [a-|O lac || ]3/>[S[x|>|N[o| 7 [I< | I 
+16) <)g)O)/O]w)u|O/z|—|5|</4/5/2/0 
69S —|en[oo] st [ta [co| [ooo] --|--/V LILA 
GOH (SGC EE Se 

slo belgie sMO@ se cen 


158 


APPENDIX B 


MATHEMATICAL FUNCTIONS 


Derived Functions 


Functions that are not available in MSX BASIC can be derived by using 


the following formulae: 


Function 


SECANT 
COSECANT 
COTANGENT 
INVERSE SINE 
INVERSE COSINE 
INVERSE SECANT 


INVERSE COSECANT 


INVERSE COTANGENT 
HYPERBOLIC SINE 
HYPERBOLIC COSINE 
HYPERBOLIC TANGENT 
HYPERBOLIC SECANT 


HYPERBOLIC COSECANT 


HYPERBOLIC 
COTANGENT 

INVERSE HYPERBOLIC 
SINE 

INVERSE HYPERBOLIC 
COSINE 

INVERSE HYPERBOLIC 
TANGENT 

INVERSE HYPERBOLIC 
SECANT 

INVERSE HYPERBOLIC 
COSECANT 

INVERSE HYPERBOLIC 
COTANGENT 


Microsoft BASIC Equivalent 


= 1/COS(X) 
= 1/SIN(X) 
= 1/TAN(X) 
= ATN (X/SQP(—X*X + 1)) 


—ATN (X/SQR(—X*X+1)) + 1.5708 

ATN (1/SOR (X*X — 1) 

+ (SGN(X) — 1)* 1.5708 

ATN (X/SQR (X*X — 1) 

+ (SGN(X) — 1)*1.5708 

—ATN(X) + 1.5708 

(EXP(X) — EXP ( —X))/2 

(EXP(X) + EXP( —X))/2 

(EXP(X) — EXP(—X))/(EXP(X) + EXP(—X)) 
2/(EXP(X) + EXP ( —X)) 

2/(EXP(X) — EXP( —X)) 

(EXP(X) + EXP(—X))/(EXP(X) — EXP(—X)) 


LOG(X + SOR(X*X + 1)) 

LOG(X + SQR(X*X — 1)) 

LOG ((1 + X)/(1 — X))/2 

LOG ((SQR( —X*X + 1) + 1)/X) 

LOG ((SGN (X)*SQR (X*X + 1) + 1)/X) 


LOG ((X + 1)/(X — 1))/2 


APPENDIX C 
ERROR CODES AND ERROR 
MESSAGES 


Code Message 


1 


Ww 


> 


ol 


a 


NEXT without FOR 
A variable in a NEXT statement does not correspond to any 
previously executed, unmatched FOR statement variable. 


Syntax error 

A line is encountered that contains some incorrect sequence of 
characters (such as unmatched parentheses, misspelled command 
or statement, incorrect punctuation, etc.) 


RETURN without GOSUB 
A RETURN statement is encountered for which there is no previous, 
unmatched GOSUB statement. 


Out of DATA 
A READ statement is executed when there is no DATA statement 
with unread data remaining in the program. 


Illegal function call 
A parameter that is out of the range is passed to a math or string 
function. An FC error may also occur as the result of: 


1. anegative or unreasonably large subscript 

2. anegative or zero argument with LOG 

3. anegative argument to SQR 

4. an improper argument to MIDS, LEFT$, RIGHTS, INP, OUT, 
PEEK, POKE, TAB, SPC, STRINGS, SPACES, INSTRS or 
ON.... GOTO. 


Overflow 
The result of a calculation is too large to be represented in BASIC’s 
number format. 
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7 Out of memory 
A program is too large, has too many files, has too many FOR loops 
or GOSUBs, too many variables or expressions that are too 
complicated. 


8 Undefined line number 
A line reference ina GOTO, GOSUB, IF... THEN... ELSE 
is to a nonexistent line. 


9 Subscript out of range 
An array element is referenced either with a subscript that is outside 
the dimensions of the array, or with the wrong number of subscripts. 


10 Redimensioned array 
Two DIM statements are given for the same array, or DIM 
statement is given for an array after the default dimension of 10 
has been established for that array. 


11 Division by zero 
A division by zero is encountered in an expression, or the operation 
of involution results in zero being raised to a negative power. 


12 Illegal direct 
A statement that is illegal in direct mode is entered as a direct mode 
command. 


13 Type mismatch 
A string variable name is assigned a numeric value or vice versa; 
a function that expects a numeric argument is given a string 
argument or vice versa. 


14 Out of string space 
String variables have caused BASIC to exceed the amount of free 
memory remaining. BASIC will allocate string space dynamically, 
until it runs out of memory. 


15 String too long 
An attempt is made to create a string more than 255 characters 
long. 


16 String formula too complex 
A string expression is too long or too complex. The expression 
should be broken into smaller expressions. 


8 


8 
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Can’t continue 

An attempt is made to continue a program that: 

1. has halted due to an error, 

2. has been modified during a break in execution, or 
3. does not exist. 


Underfined user function 
FN function is called before defining it with the DEF FN 
statement. 


Device 1/O error 

An |/O error occurred on a cassette, disk drive, printer, or CRT 
operation. It is a fatal error; i.e., BASIC cannot recover from 
the error. 


Verify error 
The current program is different from the program saved on the 
cassette, 


No RESUME 
An error trapping routine is entered but contains no RESUME 
statement. 


Unprintable error 
A RESUME statement is encountered before an error trapping 
routine is entered. 


Unprintable error 

An error message is not available for the error condition which 
exists. This is usually caused by an ERROR with an undefined 
error code, 


Missing operand 
An expression contained an operator with no operand 
following it. 


Line buffer overflow 
An entered line has too many characters. 


Unprintable errors 
These codes have no definitions. Should be reserved for future 
expansion in BASIC. 


Bish ERRORS 


51 


52 


57 


59 


” 


255 


FIELD overflow 

A FIELD statement attempts to allocate more bytes than were 
specified for the record length of a random file in the OPEN 
statement. Or, the end of the FIELD buffer is encountered while 
doing sequential 1/O (PRINT#, INPUT#) to a random file. 


Internal error 
An internal malfunction has occurred, Report to Microsoft the 
conditions under which the message appeared. 


Bad file number 

A statement or command references a file with a file number 

that is not OPEN or is out of the range of file numbers specified by 
MAXFILES statement. 


File not found 
A LOAD, KILL or OPEN statement references a file that does 
not exist in the memory. 


File already open 
A sequential output mode OPEN is issued for a file that is already 
open; or a KILL is given for a file that is open. 


Input past end 

An INPUT statement is executed after all the data in the file has 
been INPUT, or for null (empty) file. To avoid this error, use the 
EOF function to detect the end of file. 


Bad file name 
An illegal form is used for the file name with LOAD, SAVE, KILL, 
NAME, etc. 


Direct statement in file 
A direct statement is encountered while LOADing an ASCII 
format file. The LOADing is terminated. 


Sequential |/O only 
A statement to random access is issued for a sequential file. 


File not OPEN 
The file specified in a PRINT#, INPUT, etc. hasn’t been OPENed. 


Unprintable error 
These codes have no definitions. Users may place their own error 
code definition at the high end of this range. 
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APPENDIX D 


MSX BASIC RESERVED WORDS 


BASIC statements and function names are reserved. That is, the key 
words cannot be used in variable names. This appendix lists all of the 
MSX BASIC language words that are reserved. If you attempt to use any 
of the words listed below as the name of the variable, an error is indicated 
by the computer. 


ABS 
ASC 
ATN 
AUTO 
BASE 
BEEP 
BINS 
BLOAD 
BSAVE 
CALL 
CDBL 
CHR$ 
CINT 
CIRCLE 
CLEAR 
CLOAD 
CLOAD? 
CLOSE 
CLS 
COLOR 
CONT 
cos 
CSAVE 
CSNG 
CSRLIN 
DATA 
DEF FN 
DEFINT 
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DEFDBL 
DEFSNG 
DEFSTR 
DEFUSR 
DELETE 
DIM 
DRAW 
END 
EOF 
ERASE 
ERL 
ERR 
ERROR 
EXP 
FIX 
FOR 
FRE 
GOSUB 
GOTO 
HEX$ 
IF GOTO 
IF THEN 
INKEYS 
INP 
INPUT 
INPUTS 
INPUT# 
INSTR 


INT 
INTERVAL ON 
INTERVAL OFF 
INTERVAL STOP 
KEY 

KEY LIST 
KEY (n) ON 
KEY (n) OFF 
KEY (n) STOP 
KEY ON 

KEY OFF 
LEFTS 

LEN 

LET 

LINE 

LINE INPUT 
LINE INPUT# 
LIST 

LLIST 

LOAD 
LOCATE 

LOG 

LPOS 

LPRINT 
LPRINT USING 
MAXFILES 
MERGE 

MIDS 


MOTOR ON 
MOTOR OFF 

NEW 

NEXT 

OCcT$ 

ON ERROR GOTO 
ON GOSUB 

ON GOTO 

ON INTERVAL GOSUB 
ON KEY GOSUB 
ON SPRITE GOSUB 
ON STOP GOSUB 
ON STRIG GOSUB 
OPEN 

OUT 

PAD 

PAINT 

PDL 

PEEK 

PLAY 

POINT 

POKE 

POS 

PRESET 

PRINT 

PRINT USING 
PRINT# 

PRINT# USING 


PSET 

PUT SPRITE 
READ 

REM 
RENUM 
RESTORE 
RESUME NEXT 
RESUME O 
RETURN 
RIGHTS 
RND 

RUN 


SAVE 
SCREEN 
SGN 

SIN 

SOUND 
SPACES 
SPC 

SPRITE ON 
SPRITE OFF 
SPRITE STOP 
SPRITES 
SQR 


STR$ 
STICK 
STOP 
STOP ON 
STOP OFF 
STOP STOP 
STRIG 
STRIG ON 
STRIG OFF 
STRIG STOP 
STRINGS 
SWAP 


TAN 
TIME 
TROFF 
TRON 
USR 
VAL 
VARPTR 
vpP 
VPEEK 
VPOKE 
WIDTH 
WAIT 
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APPENDIX E 
MEMORY MAPS & 1/0 PINOUTS 


MEMORY MAP 


bank 1 bank 2 bank 3 


DISK 
DRIVE 
ROM 
FFF 
EXPANSION GAME EXPANSION 
MODULE SLOT SLOT 
INTERFACE 


1/0 EXPANSION MODULE INTERFACE AND GAME SLOT 
PIN LAYOUT 


reserved 

WAIT (note 2) 
Mi 

iORO 

WR 


RESET reserved 
AQ A 15 
A 10 
A6 
A8 


Al 
A3 
AS 
D1 
D3 
D5 
D7 
GND 
GND 
+5V 
+5V 
SUNDIN 


Note: (1) Input & output is measured with respect to SV1-728. 
(2) Open collector output. 
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SV1I-728 EXPANSION MODULE INTERFACE AND GAME 
SLOT SIGNAL DESCRIPTION 


Fame DESCRIPTION 


ROM 4000 ~ 7FFF select signal 

ROM 8000 ~ BF FF select signal 
ROM 4000 ~ BFFF select signal 

Slot selected signal signal. Fixed select 
signal for each slot. 


Reserved for future use only 
Refresh signal 

Wait signal to CPU 

Interrupt request signal 


Fetch cycle signal of CPU 

This signal controls the direction of 
external data bus buffer when the cartridge 
is selected. It is low level when the data is 
sent by the cartridge. 


1/O request signal 


Memory request signal 


Write signal 

Read signal 

System reset signal 
Reserved for future use only 
Address bus 

Data bus 

Ground 

CPU clock 3579MHz 
Ground 

Insert/remove protect 
+ 5V power supply 

+ 12 power supply 
Sound input (—5dbm) 
—12V power supply 


CASSETTE 


co [oe [iw |e 


GND 
GND 
CMTOUT 
CMTIN 


REM + 
REM — 
GND 


PRINTER 
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KEYBOARD 


INPUT 7 INPUT 6 


INPUT 5 INPUT 4 
INPUT 3 INPUT 2 
INPUT 1 INPUT O 
OUTPUT 9 OUTPUT 8 
OUTPUT 7 OUTPUT 6 
OUTPUT 5 OUTPUT 4 
OUTPUT 3 OUTPUT 2 
OUTPUT 1 OUTPUT 0 
CAPS +5V 

GND 


FORWARD/SCK 
BACKWARD/SI 
LEFT/CS 
RIGHT/SENCTR 
+5V 

TRIGGER 1 
TRIGGER 2 
OUTPUT 

GND 
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TEXT 


HIGH AND LOW 
RESOLUTION 


APPENDIX F 
NOTES ON SCREENS 


The screen @ command dllows the display of 
39 characters per line; while the screen 1 
command caters for 29 characters. Both screens 
hold 24 rows per screen. The default is 29 
characters per line. If screen @ is on, by means 
of the ‘WIDTH 49” command, 4@ characters 
per line can be displayed. 


The 64 x 48 grid you see in figure 2-3 in 
Chapter 5 can be treated as a separate screen. 
The 64 by 48 grid is called a “low resolution 
graphics screen” and the 256 by 192 is called 
a “high resolution graphic screen,"’ Every 4 
boxes of the 256 by 192 grid is treated as one 
unit on the 64 x 48 grid. The box numbers in 
Figure 2 in Chapter 5 should be multiplied by 4 
to appear in the proper places on the screens. 
This will maintain compatibility between the 
low resolution and high resolution screen. 


e) 1 2 3 


Each of the four boxes is treated as an 
individual point on a high resolution screen. 


The screen 3 command draws on the low 
resolution screen, and the screen 2 command 
draws on the high resolution screen. Thus if 
you PSET one of these four boxes on a high 
resolution screen, only that one will be lit up. 
But on a low resolution screen, if you turn on 
any one of these boxes all of them will be lit. 


APPENDIX G 
TROUBLE SHOOTING CHART 


SYMPTOM POSSIBLE CAUSE REMEDY 
NO POWER Power Switch Turn on power switch 
not turned ON. on the righthand side 
of the machine. 
Power cable not Be sure the power cable 
connected is connected to the 
computer and the wall 
sockets. 
Blown fuse in the Return the system to an 
computer authorized dealer for 
replacement. 
NO SOUND OR Wrong TV hook up Hook up the computer 
PICTURE to the ““VHF”’ antenna 
terminals. 
Loose video cable Be sure all video 
cables are securely 
fastened. 
NO SOUND TV volume too low Adjust the volume 
control of TV. 
NO COLOR Adjust TV Color 
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level and fine tune 
the TV. 
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APPENDIX H 
PROGRAMMABLE 
SOUND 
GENERATOR (PSG) 


Other than the PLAY statement which allows 
you to create musical notes, you can use the 
SOUND statement to directly control the 
various capabilities of the Programmable 
Sound Generator which we will refer to as the 
PSG. 


A PSG SOUND statement take the form of: 


SOUND < Register of PSG > < value > 


where < register of PSG > is one of the 13 
available registers the PSG uses, and 

< value > is a number between 1 to 255. The 
function of creating a specific sound or sound 
effect logically follows the control sequence 
listed below: 


REGISTER FUNCTION 
RO-RS 
Program noise period 


| Noise generator control] R6_ 
Mixer control R7 Enable tone and or noise on 
selected channels 


Amplitude control Select “fixed” or ‘envelope 
variable’ amplitudes 
Envelope generator Program envelope period 
| etetentope pen 


TONE The PSG has 3 tone channels A, B and C. The 
GENERATOR frequency for each channel is obtained by 
CONTROL counting down the input clock by 16 times the 


value of the frequency wanted. 


AMPLITUDE 
CONTROL 


For example: 


Desired value = 3579545/ (16 * frequency) 
Low register = <Desired value> AND 255 


High register = <Desired value> / 256 


The high and low registers correspond to the 
register pair used by each control. 


Channel Register 
A 1,6 
B 3,2 
Cc 5,4 


Program example follow: 


19 INPUT “ENTER FREQUENCY”;A 

20 F = 3579545 / (16 * A) 

30H =1 / 256 

49 L =F AND 255 

50 SOUND 0,L 

6 SOUND 1,H 

70 SOUND 8,15: PRINT’ VOLUME 
CONTROL OF CHANNEL A” 

89 SOUND 7,254 : PRINT” BINARY 
11111119 TO ENABLE CHANNEL A” 

99 END 


In the previous example program, you should 
notice we used register 8 to enable 

volume of channel A. The PSG has three 
separate registers to control the amplitude 

of the different channels. 


Channel Register 
A 8 
B 9 
c 19 


Each channel can have a volume from @ to 15 
with 15 being the loudest. 


MIXER 
CONTROL 


REGISTER 7 


For example: 


10 SOUND 0, 100 

20 SOUND 1,6 

390 SOUND 7,254 : REM TURN 
ON CHANNEL A (MIXER) 

40 FOR |= 15 TO@ STEP —1 


50 SOUND 8,1 

60 FOR J=1 TO 206 : NEXT J: 
REM DELAY 

70 NEXT! 


You will hear a high pitched sound fading 
away, because we changed the volume of 
channel A from 15 through @. 


The amplitude control register can also be 

used to direct the envelope period of each 
channel, by setting the amplitude channel to a: 
value of 16, the amplitude of the 

corresponding channel would be controlled by 
register 11, 12 and 13. For more information on 
this, refer to Envelope Period Control 

Registers. 


The MIXER register, register number 7, 

controls the three Noise / Tone channels. The 
Mixers, as previously described, combine the 

noise and tone frequencies for each of the 

three channels. The determination of 

combining neither, either or both noise and 

tone frequencies on each channel is made by 

the state of Bit @— Bit 5 of register #7. Bit 6 and 7 
are for I/O ports connected through the PSG, 

and these are ignored by BASIC. 


| ee] me | me | | | | 


Not used Sound channel 


rere | @ [me ) Ae |e] A | 


Bits logical value 
1 if channel is disabled 9 if channel is enabled 


ENVELOPE 
PERIOD 
CONTROL 
REGISTER 


For example: 


SOUND 7,&B11111118 


will turn on tone channel A. 


SOUND 7, &B11119110 


will enable both noise and tone channel A. 


The generation of fairly complex envelope 
patterns can be accomplished by two different 
ways in BASIC. First, it is possible to vary the 
frequency of the envelope using register 11 
and 12 as a 16 bit register ; and second, the 
relative shape and cycle of the envelope can be 
varied by using register 13. 


For example: 


< Desired envelope freq > = 3479545/ (256* freq) 


Program example: 


10 SOUND 0,160 

20 SOUND 1,0 : REM Tone channel A 

36 SOUND 7, &B11111116: REM Enable A 

40 SOUND 8,16 : REM Value of 16 to 
enable E/P reg. 

50 SOUND 13,14 : REM Shape select 

60 S=.5:REM.5 Hz 


70 K = 3579545 
80 L = K/ (256*S) AND 255 
90 H = K/ (256*S) /256 

190 SOUND 11,L 

119 SOUND 12,H 

120 END 


NOTE: Register 13 is the shape register described 
next . 
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SHAPE You can select 9 different shapes for the 
REGISTER envelope period output, by programming the 
shape register #13. 


Selected value Shape 

9,1,2,3,9 PN ey 
4,5,6,715 | 
8 NINAWNN 
12 Vrs 
11 N 

12 SV 
13 7 

14 POE 


—> << Envelope Period 


For example: 


| SOUND 13, 14 


will create a tone modulating up and down 
according to the envelope period set in 
registers 11 and 12, when the enable bit 4 of 
register 8 (SOUND 8, 16) is set. 
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NOISE 
GENERATOR 


PSG BLOCK DIAGRAM 


REGISTERED ARRAY (14 READ/WRITE CONTROL REGISTERS) 


| 


AL 


IE Tl hraepeedichdaretees TTT. #8 cows Fone TONE 
a2 _| PBB Fine Tune® GENERATOR 
rg] onal} Tove Pee’ MMIII 4 ®* Coarse Tone 8 
PRS ee Ti 
TRG _| Noise Period i 
— 
cae 
Re | A Amplitude mM 
Ro | Me 
[RF [Crane Ameiuce MMA w {es [2 Ts Ts 
7 beeatad sr Coser Te AMPLITUDE st ees 
ats | Enns Shane Grex INTC" | aCe [ro ne 3) 


Remarks: CONT = Continue 
ATT = Attack 
ALT = Alternate 


GENERATOR 


ANALOG 
CHANNEL C 
ANALOG 
CHANNEL 8 


ANALOG 
CHANNEL A 


a, Ae ee ee oe Ge 


178 


APPENDIX | 
INTRODUCTION TO 
BASIC PROGRAMMING 
(BASIC GRAPHICS and 
BASIC SOUND) 


In learning to use your SV1-728 computer, you 
use many different commands and 
programming techniques. However, if you are 
like most people, you would like to be able to 
do something NOW to see your computer in 
action. To help you do this, we will guide you 
through some very simple examples to prepare 
you for the things you will be exposed to later 
in the user’s manual. 


We are going to assume that you have read 

the systems overview and set-up procedures in 
your SV1-728 owner’s manual, and have set up 
your computer properly. First, turn the 
television or monitor on and then turn on you 
SV 1-728. Watch and you will see that the 
SPECTRAVIDEO logo appears on the screen, 
changing colors 3 times. The screen then 

clears and displays the amount of memory 
available. When the square cursor appears 
below this information, it is your indication that 
the SVI-728 is waiting for your instructions. 


The first command that we will explore is one 
that controls the color of the screen and the 
characters that appear on it. 


COLOR 


CLS 


This command allows you to vary the colors of 
the display in any manner you choose. You 
can choose from 16 colors, denoted by the 
numbers @ to 15. As an example, type in the 
following line: 


COLOR 6, 1 


Now press the ENTER key. When you do this, 
you will see that the screen will change from its 
normal colors of blue background with white 
letters to a black screen with orange letters. 
You can explore the various colors that are 
available by varying the numbers you type 
after the “COLOR” command. When you have 
completed this exploration, turn the computer 
off and then back on. This will clear all the 
memory and return the system to its original or 
“default’’ condition. There are other ways of 
accomplishing this, by the way, and they are 
explained in greater depth in the user’s 

manual. 


Now, let’s program a line in to the computer 
that will cause it to print you name on the top 
of the screen. Type in the following line: 


18 CLS 


Now, type RUN and press the ENTER key. 
You will see that the screen has cleared and 
that the word “Ok” is printed on line 1 with 
the cursor (white square) below. The 
command “’CLS” (Clear Screen) is the 
command that clears the screen anytime the 
computer finds it in a program. 


Now, type this line: 


20 PRINT “SPECTRAVIDEO” 


Type RUN and press ENTER again, and you 
will see that the word ““SPECTRAVIDEO” now 
appears on the top line of the screen with the 
word ‘‘Ok” and the cursor below. What you 
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have just done is to write a two-line program! 
Now, we will edit that program. First, type 
LIST and press the ENTER key. This will cause 
the program that you just wrote to be 
displayed on the screen. Now, using the 
joystick cursor control, move the cursor so that 
it is placed on the “’S” of “SPECTRAVIDEO.” 
Presss the [INS/PASTE| key on the keyboard and 
you will see that the cursor is now only half as 
tall as it was. This indicates that it is in the 
“INSERT” mode. To begin this edit, simply 
type in your name. The line should now look 
like this: 


26 PRINT “YOUR NAMESPECTRAVIDEO” 


The half-height cursor should still be located 
over the ‘’S” in “SPECTRAVIDEO.” Now, 
press thel DEL/CUT]key once and you will 
see that the ‘’S’’ has disappeared and that the 
cursor is now located over the ‘’P’’, You have 
deleted the ’’S’’. Do the same thing for all of 
the letters remaining until you get to the 
quotation mark. When the cursor is located 
over this mark, press the ENTER key. 


Your edit is now completed. If you have 
followed all of the above steps, listing the 
program should cause the screen display to 
look like this: 


10 CLS 


20 PRINT “YOUR NAME” 


“RUN” the program and you will see that your 
name is now at the top of the screen. 
Congratulations! You have created and edited 
a program using the built-in editor of your 
SV1I-728. 


—————— 
BASIC GRAPHICS 


Another area that will allow you to quickly 
explore the power in your SV1-728 is that of 
graphics. To see this in action, type in the 
following line, pressing ENTER after each is 
completed: 


18 CLS 
20 SCREEN 2 


30 CIRCLE (128,86), 69, 11 
40 PAINT (128,89), 11 
58 GOTO 49 


Now, type RUN and you will see a yellow circle 
appear on the screen and then it will be filled in 
by the SVI-728’s yellow paint brush. To 
understand how this happens, let’s look at 

each line individually. 


As explained above, this line clears the screen. 
It is a good idea to place this line near the 
beginning of any program, so that you begin 
with a clean screen. 


This line causes the computer to display its 
graphics screen (#2). You always have a 
choice of four screens using BASIC and the 
screen you were using in the first example was 
screen 1. This is the screen that is always 
displayed when the computer is turned on 
(which is why you didn’t have to add a line 
to the first program to use this screen). 


39 CIRCLE (128,86), 69, 11 


Here, you are telling the computer to draw a 
circle at a point that is 128 points from the left 
side of the screen, 80 points down from the 
top of the screen, with a radius (distance from 
the center of the circle) of 69 points and with a 
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LINE & 
BOX 
DRAWING 


yellow (the number 11) border. 


40 PAINT (128, 80), 11 


This is the line that tells the SVI-728 to use its 
paintbrush to fill in the circle you have just 
outlined in line 30. You must use the same 
coordinates (128,80) and the same color (11) 
as used in the previous line. 


58 GOTO 40 


The last line in the program causes the 
program to repeat line 40 until you stop the 
program by pressing the CTRL and STOP keys 
at the same time. You will also notice that 
when you do this, the screen clears and the 
cursor moves to the top left hand corner. This 
is because the display has returned to 

screen 1 referred to above. You can 
®xperiment with the numbers in this program 
to vary the location, size or color of the circle 
being painted. 


The first number following the “CIRCLE” 
command (the X axis) may range from @ to 255 
and the second number (the Y axis) may range 
from @ to 191. 


Now that you have seen what your SV1-728 can 
do with circles and its paintbrush, we'll take a 
look at lines and boxes. The computer has the 
same simple method for drawing them as it 
does for circles. First, type NEW to clear the 
memory of the program we were using before. 
Now, enter the following lines: 


19 CLS 
20 SCREEN 2 


30 LINE (50,40) — (200, 150) 
49 GOTO 49 


When you run this program, you will see that a 
line has been drawn from high on the left side 
of the screen to a low point on the right side of 


the screen. The line that causes this to happen 
is line 30: 


30 LINE (50,49) — (200, 156) 


This line tells the computer to draw a line from 
a position 59 points from the left margin of the 
screen and 40 points down from the top over 
to a position that is 200 points from the left 
margin and 150 points down from the top. 


Now, you can simply convert this same line 
into a box command by changing the line to 


read as follows: 


30 LINE (50,40) — (200, 150), 19,B 


By running the program now, you will see a 

box on the screen, By adding the ‘’,10’’ following 
the parentheses, you defined the color of the 
box border and the ‘’B” tells the computer to 
draw a box at the same coordinates as the line. 
To tell the computer to use the paintbrush, 
change the line to read: 


30 LINE (50,40) — (200, 150), 10,BF 


Now you will see that the program draws the 
same box and paints the inside with the same 
color as the border. 


183 


184 


PLAY 


O (OCTAVE) 


—————————————————— 
BASIC MUSIC 


There is also a very powerful music synthesizer 
built into the SV1-728 that can be easily used, 
through simple BASIC commands, to produce 
music. The key to this synthesizer is the 
BASIC statement: 


PLAY “ABC” 


followed by pressing the enter key. This will 
produce musical tones from your SV1-728 
through the speaker on your television or 
monitor. You could achieve similar results 

by writing a BASIC program with the following 
lines: 


20 PLAY “ABC” 


26 GOTO 10 


There are numerous other things that can be 
done with sound using the synthesizer in your 
SV 1-728. We will look at the simple ones in this 
section and progress to the more complex 

ones in later pages. We will continue to work 
with the BASIC program listed above, and 
make changes in it as we go along. 


First, change line 10 to read: 


10 PLAY “O1ABC” 


Now, when you run the program, you will 
hear that the sounds produced are at a 
very low pitch when compared with the 
first ones you made. This is because you 
have set the OCTAVE by adding the ’O1” 
before the ‘‘ABC.” This is the command 
that allows you to access 8 octaves with 
the synthesizer. Now add this line: 


11 PLAY “O4ABC” 


T (TEMPO) 


L (LENGTH) 


When the program is run, you will hear 
three low notes followed by three higher 
notes. The octaves you can access using 
the “‘O” command can range from 9 
(lowest) to 7 (highest). 


Now, change line 10 to read: 


10 PLAY “T3201ABC” 


The program will now play the same note you 
heard before but at a much slower rate. What 
you did by typing the “T32” before the 
“‘O1ABC" was to set the TEMPO or speed of 
the music. The values for ‘’T’’ can range from 
32 (slowest) to 255 (fastest). 


You will also notice that the notes in line 11 
also play at the slower pace. This is because 
the synthesizer will play at whatever tempo 
you set until you tell it to play at a different 
tempo. To see this in action, change line 11 to 
read: 


11 PLAY “T25504ABC” 


Now, as you can hear, the notes from line 11 
play at a much faster pace than those in line 


19. 


You can also control the length of each note 
individually. To see this, change line 19 to read: 


19 PLAY “T25501ABL1C” 


This changes the ’C’’ note to a much longer 
duration than “A” or ’B’’ and also causes the 
notes in line 11 to play for a longer time. This 
length command can be placed in front of any 
note to control the length of the note. The 
lengths of the notes can be varied from 1 
(longest) to 64 (shortest). 


RNS LOTTIE a RSE 
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S(SHAPE) & 
M(TONE) 


R (REST) 


Two other BASIC commands that can be 
applied to sounds are the ‘‘S” command and 
the “‘M’’ command. These two commands 
determine the tonal qualities of the note being 
played. As an example of this, the same note 
played on a piano and a trumpet may be at the 
same pitch but will have two distinctly different 
sounds, These two commands allow you to 
shape the notes you are creating in the same 
way. 


The ‘’S’”’ command controls the shape of the 
note. As an illustration of this, change line 19 


to read: 


10 PLAY “S104ABC” 


| 


and eliminate line 11 by typing 11 and pressing 


Now, run the program to see the differences in 
the sounds you hear. These shape commands 
can be considered the voices of the 

synthesizer. There are 14 of them built into the 
SVI-728. This means that the number used to 
set the ‘“’S’’ command can range from 1 to 14. 


The “’M’’ command controls the tone period or 
to be more specific, the amount of time that 
you will hear each note based on its tonal 
qualities. To see how this works, change line 
16 to read: 


10 PLAY “S19M500604ABC” 


As you will hear, this changes the sound 
dramatically. The values used to set ““M”’ can 
range from 1 to 65535. 


You can also insert pauses between notes by 
using the ““R’’ command. Change line 19 to 
read: 


10 PLAY “O4AR1BR19C” 


V (VOLUME) 


USING 3 
CHANNELS 
OF SOUND 


This causes the “A” note to play, followed by 
a brief period of silence. Then the ’’B’”’ note 
plays, then a shorter period of silence, then the 
“C” note followed immediately by the ““A”’ 
note again. 


The final command we will examine in this 
section is the ““V“’ command. This command 
is used to set the volume of the sound being 
produced. Change line 19 to read: 


| 10 PLAY “O4V5AV10BV15C” | 


You will now hear that each note gets louder 
than the one before it. You can set the volume 
from @ to 15. 


So far, we have only used one note at a time to 
demonstrate the use of the synthesizer. 
However, the SV1-728 has three separate 
channels of sound that can be programmed 
individually to play together to create chords. 
Change line 1 to read: 


19 PLAY “O1ABC”, “O3CDE”, “OSFAG” 


What you hear now is three notes being played 
in combination to create a chord, You can also 
have each channel play something entirely 
different from the others to create melody and 
harmony parts in the music you create. 


These are just a few of the exciting things that 
your SV1I-728 Computer System can do for you. 
To begin exploring your machine in greater 
depth, read each chapter in this user’s 

manual and follow the examples. Have Fun 

and Good Luck!!! 


Re SSE OE 
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APPENDIX J 
GLOSSARY 


Although most of the words that appear in the glossary were not used 
in this manual, we have included them for your future reference: 


access time The time between the instant that an address 
is sent to a memory location and the instant 
data returns. 


accumulator One of several registers which temporarily 
store, or “accumulate” the results of various 
operations. 

address The digital number used by the CPU to 


specify a location in memory. 


ALU Arithmetic Logic Unit. The part of a CPU that 
adds, subtracts, shifts, ANDs, ORs and 
performs other computational and logical 
Operations. 


alphanumeric A device or a system that includes both 
alphabetical and numerical characters. 


architecture The organizational structure of a computer 
system. 

array A list of values stored in a series of memory 
locations, 

ASCII American Standard Code for Information 


Interchange. Consists of 128 letters, numbers, 
punctuation marks, and special symbols. Each 
of which consists of a binary pattern that uses 
eight digits. 


BASIC 


baud 


binary 


bit 


boolean logic 


bootstrap 


branch 


clock 


[ 


A software program which converts symbolic 
or mnemonic language into machine. 
language. 


Beginners All Purpose Symbolic Instruction 
Code. A high level programming language 
designed for the beginning programmer. 


A unit by which signal speeds are measured. 
In microprocessing, the baud rate refers to the 
number of bits per second. 


A numbering system that has 2 as its base, and 
that uses only the digits @ and 1. Used by 
digital computers to perform the tasks in data 
processing. 


Binary digit. Single element of a binary 
number with a value of either @ or 1. 


Mathematical logic processes based on a 

system of algebra developed in the early 
nineteenth century by an English mathematician 
George Boole. 


A technique or device for loading the first 
instructions or words of a routine into 
memory. These instructions are used then to 
bring in the rest of the routine. 


A way of re-routing a program so that it 
branches to another set of instructions to 
perform another task. 


An error or defect in the hardware or software 
of the computer, causing a malfunction. 


A set of wires of conductors arranged in 
parallel, used to transmit data, signals or 
power between parts of a computer system. 


A group of eight bits, operated upon as a unit. 
A device or circuit that sends out timing 


pulses to synchronize the action of the 
processor. 


command 


compiler 


controller 


CPU 


CRT 


cursor 


data 


data bus 


debug 


DMA 


disk 


DOS 


dump 


Common Business Oriented Language. A 
high level language used in many business 
applications. 


An instruction to the computer that causes 
something to happen. 


A program to convert a high level language 
into assembler or machine language 
(understood by the computer). 


An interface which allows the control of an 
1/O device by the central processing unit. 


Central Processing Unit. The part of the 
computer that controls all execution of 
instructions and arithmetic operations. 


Cathode Ray Tube. The display on which 
information is shown after program execution. 


A symbol displayed on the screen indicating 
where the next character is to be displayed. 


Essentially, information that is input to the 
computer. 


An electrical path along which information 
Passes. 


To delete any errors in program, 


Direct Memory Access. The accessing of 
memory without intervention of the central 
processing unit. 


A plate resembling a record album with a 
magnetic surface used to store data or 
programs. Also known as ‘floppy disk”’. 


Disk Operating System. The program used for 
implementation of a disk drive. 


The transfer of information from one piece of 
equipment to another. 


SS ne ST NTE 


editor 


execute 


expression 


fetch 


file 


firmware 


floppy disk drive 


flowchart 


format 


FORTRAN 


gate 


hardware 


A program used for the creating and/or 
altering of text in another program. 


The final step in running a program. An 
execution will perform the operation specified 
in the program. 


A particular grouping of numbers, letters or 
variables that comprise a single quantity. 


Refers to the reading out of an 
instruction/data from an addressed memory 
location. 


A collection of organized records that are 
usually on one particular subject. 


The programs that are built into the ROM of a 
microcomputer. 


A peripheral device used to store data from 
and input data to the computer. It is 
an input/output device. 


A diagram used in the development of a 
computer program. A flowchart shows the 
sequence of steps to take. 


The particular arrangement or layout of data 
on a data medium, such as a screen or a 
diskette. 


FORmula TRANslation. A high level language 
using algebraic notation. 


An electrical signal circuit, with two (or more) 
inputs and one output, that behaves as a 
switch to create a particular state (either a 
binary one or zero). 


The physical components that make up a 
particular computer system include all the 
peripheral devices. 
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hexadecimal 


high level language 


1/O devices 


instruction 


instruction set 


interface 


interpreter 


keyboard 


kilobyte or K 


library 


location 


A numbering system used in computers. Use 
the digits @-9 and the letters A-F. 


A programming language that is easier to 
understand and more convenient for the 
programmer. BASIC, FORTRAN, PASCAL 
and PL-1 are some examples of high level 
languages. 


/nput/output devices. These would include 
the disk drive, data cassette, keyboard, 
printer, TV/ monitor, ete. 


A command telling the computer to perform a 
specific task. 


This. is- the set of instructions built into the 
firmware of the microcomputer. This 
instruction set is used by the programmer. 


This is the way in which peripheral devices are 
linked to the mainframe console of the 
microcomputer. 


A program that converts one instruction at a 
time into machine language understood by the 


computer. 


This is the console of the computer through which 
data is input to the CPU. 


Equivalent to 1024 bytes. 


A collection of files or records that a person 
can access easily. 


To enter a program into a computer’s 
memory. 


The portion in memory in which a data word 
or an instruction is stored. 


A particular way of reasoning using thought 
processes. 


loop A series of instructions that allow the 
programmer to repeat a particular sequence of 
events in a program. 


LSI Large Scale Integration. An integrated circuit 
that has thousands of components packed in 
one chip. 

machine language This is the language of the computer that is 


the lowest level the computer itself can accept 
as a program. This language is used with 
either binary, octal or hexadecimal numbering 
systems. 


memory The part of the computer that stores data and 
instructions. Each instruction uses a particular 
address which tells the CPU where to fetch 
from. 


menu This is a list much like the one in your local 
restaurant, except this type of menu lists what 
the computer is ready to do for you. 


microprocessor This is also known as the Central Processing 
Unit. It is comprised of one or more LSI 
circuits that control all the processes of the 
computer. 


mnemonics These are abbreviated terms for instructions 
used so that the programmer can easily 
remember them. 


modem MOdulater DEModulator. This is a device used 
to convert data to signals that can be 
transmitted over telephone lines and then 
back to data again at the receiving end. 


octal A numbering system used in computers 
employing the digits @-7. 


on-line Whenever a peripheral device is interacting 
with its host computer, it is said to be ‘‘on 
line’. For example, a printer is said to be “‘on- 
line’’ when it is doing a computer printout. 


SS ee a 


operating system 


output 


peripheral 


pixel 


pointer 


program 


program counter 


prompt 


RAM 


The “‘OS” of a computer system is the 
program that directs such things as 
input/output, memory allocation, interrupt 
processing. It controls the overall operation 
of the computer. 


When data is said to be “output” it usually 
refers to the printout from a printer. Output 
may also be programs or data saved on a 
floppy diskette. 


A grouping of memory locations by higher 
order address bits. In an 8-bit microprocessor, 
a page usually has 256 bytes. 


Any device external from the host computer 
but used in conjunction with the computer to 
perform operations such as printouts, data 
storage and retrieval, CRT displays, 
telecommunications, graphics, etc. 


The measurement of one dot on the display 
screen. The number and arrangement of 
pixels is what determines screen resolution. 


This is the register in the CPU that contains 
the memory address. 


The sequence of instructions that tell the 
computer what task to perform. 


This is the register in the CPU that specifies 
the address of the next instruction to be 
executed. 


This is the symbol on the screen which shows 
the user that the computer is ready to accept 
input from the keyboard. 


Random Access Memory. This is the portion 
of memory that can be written into and read 
from. When the computer's power is turned 
off, anything written will be lost. 


register 


routine 


source program 


subroutine 


terminal 


time sharing 


truth table 


utility program 


A circuit used to store or manipulate bits or 
bytes of data in the CPU. 


Read Only Memory. This is the part of 
memory that may only be read from. It is said 
to be “‘non-volatile’”, meaning that when power 
is turned off the ROM retains its information. 


A specific program designed to do a particular 
function. 


Software pertains to the programs that are 
input to the computer by the user. 


A program written in a language that is easily 
understood. 


This is a shape designed by the programmer 
when using a computer's graphic capabilities. 


A routine in a program may be used again 
to perform a specific function. 


The rules governing a command line. If the 
command line is not in proper syntax, a 
“syntax error’’ message will occur. 


An input/output device usually consisting of a 
keyboard, CRT and printer used as a work 
station. 


The process of (more than one user) sharing 
the use of a CPU via time robin. 


A truth table shows the different values that 
an AND, OR, NAND, NOR or other logic 
gate will have, according to two select inputs. 


This is a program that helps the user perform 
various specific utility functions, such as a 
debug program to find mistakes in programs. 
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variable A variable is any number or set of numbers, 
assigned a particular value, that is to be 
operated upon in a program. 


volatile storage The type of storage which, when power is 
removed, the program or data in memory is 


lost. RAM is said to be volatile. 


windows Several smaller screens displayed on one CRT 
screen at the same time. 


EA # SES ES ERTS ABS OS MOR ah ETRE OE ees 
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INDEX 


A 


Amplitude Control 


Arithmetic Operation 


Array 
AUTO 


Blank Move 
Box 
Box Fill 


C 


Channel 
CLEAR 
CIRCLE 
CLOAD” 
CLS 
COLOR 
CONT 
Containers 
CTRL-STOP 


END 
ENTER 


Envelope Period Control 


ESC 


GOSUB ...RETURN 


GOTO 


173 
107 
119 
27,113 


143 
138 
139 


154, 187 

112 

132 

27 

31,179 
27,62, 65,179 
27 

10; 7 Fe 

30 


109 
32 

118 
140 


77 
31 
175 
32 


74 


104 
27 


Wintec THEN 


LEFTS 
LEN 
Length 

tt i 
LINE 
LIST 
LIST 
LOCATE 


MID$ 
Mixer Control 


O 


Octave 
Output 


p 


PAINT 
PLAY 
PRESET 
PRINT 
PSET 


R 


READ 
Register 
REM 

Rest 
RESTORE 
RIGHTS 
RND 
RUN 


91 

108 
69,125 
45 

102 


126 

127 

152, 185 
73 

137 
27,58 
27 

142 


126 
174 


151, 184 
108 


133 
151, 184 
81 

97 

61 


152, 186 
113 

126 

102 

27 


S 


SCALE 
SCREEN 
Shape 
SPRITES 
STEP 
STOP 
String 


Tt 


TAB 

Tempo 

TIME 

Tone 

Tone Generator Control 


V 


Variables 
Volume 


141 

60 

153, 176, 186 
143 

84 

30 

125 


98 

152, 185 
102 
153, 186 
172 


70 
154, 187 
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SVI-728 MSX COMPUTER 
QUICK REFERENCE CARD 


FORMAT NOTATION 


The following rules apply to the format of a statement or command: 
1, Items in capital must be input as shown. 

2. Items in lower case letters enclosed in bracket < 
supplied by the user. 

3. Items in square brackets [ | are optional. 

4. All punctuation except angle brackets and square brackets (ie. 
commas, parentheses, semicolons. hypens, equal signs) must be 
included where shown. 
ttems followed by an ellipse ( . . . | may be repeated any number of 
times (up to the length of line). 


> ere to be 


“and “ine number” both means line number 
an 


“x, ¥" denotes X. ¥ Co-ordinates of the screen 
VARIABLE TYPE DECLARATION CHARACTER 


Variable Range No. of Byte 

$ Swing 0 © 255 characters 3+ No.of characters 
% integer —32768 w 32767 2 

1 Single precision 7 to 1 digit floating integer 4 

® Double precision 16 to 8 digit flostng pom: 8 

Others: 

6B Binary figure 

6H Hexadecimal figure 

60 Octal figure 


CHARACTER SET 


Apart from the alphabet (A to 2. to 2) and numeric (0 to 9) characters, 
other special characters are tabulated: 


Up arrow of exponentianon symbol 
Left parenthess 

Right parenthess 

Percent 


Number sgn or double precision declaration character 
Dotar or stnng variabie sign 
Exclamation point of single precision decleraton 


tated IT tetet tele a | 


Period of decemal pomt 
Single quotation merck japostrophe) or same as REM 
Semicolon 


Colon of used to ser 
same line 
Ampersand 
Quesvon mark of command PRINT 


te statements typed on the 


Clear screen and move cursor to home position 
Delete character at cursor 

Toggie inser/overtype mode 

Toggle peuse/resume program execution 
JOYSTICK/CURSOR CONTROL PAD 

There are eight possible movements for both joystick and cursor keys 


1 
8. 2 
as an 


oN 
5 


For directions 2, 4, 6 and 8. a combinaxon of two cursor keys should be 
pressed. 


PROGRAMMABLE FUNCTION KEY 


ARRED aR OIevA~e 


: 


Key Number Initial Defigition 
a color 
F2 auto (10, 10} 
F3 goto 
Fa fest 
Fs run ENTER] 
re color 18, 4, 7 (ENTER 
7 cloed™ 


F8 cont 
F9 Newt. 
‘ run 


CONTROL CHARACTER 


The ASCII control key 1s entered by pressing the key while holding 


#? 
f 
if 


Q! \—/-N«<xg<caMs0t0zEr AC ram a 
bs 

° 

& 


logical line) 


Move cursor to star of next word 


Enter current logical line 
Append to end of line 


SRESSSSBLS Reese 


10 
INS 


THU 
i 
it 
i 


8 


i 
#g 


Cursor up 


DEL Delete character et cursor 


Note: Those keys marked with asterisk cancel inser mode when editor 
is in ingen mode 


BASIC COMMAND 


AUTO [ < line number >} [ . < increment > | 
Generate line numbers sutomancalty 


Beer 
Make » beep sound 


BLOAD ~ [ < device descriptor > | | < filename >)" ([. R | 

| .<toad address > } 
Load a machine language program into memory from the specified 
dewce. 


BSAVE ~[ < device descriptor > | <filename >”, < start address > . 


< end address > [ . < execution address > | 
Save s memory image at the specified memory location to the 


i 


CLEAR | < string spece > [ . < highest location > } | 
Set of numeric venables to zero, all string vanables to null and 
close all open files and optionally, set the end of memory 


CLOAD [ “ < filename >”) 

Loed s BASIC program file from the cassette. 
CLOAD? [ “ < filename >” } 

Venty @ BASIC program on cassette with one in memory 


COLOR [ < foreground > | |, < background > }[ . < border > | 
Set colors for the screen display 


CONT 
Continue program execution after break or stop. 


DELETE [ < line number > } [ — < line number > } 
Delete program lines 


KEY < function key #@ >.“ < string > ~ 
Set a string wo @ function key 


KEY LIST 
Ust the contents of all the programmable function keys. 


KEY ON 
Tum on function key display om the 24th line of text screen. 


LIST [ < line number > } | — < line number > | 
Ust all of part of the program on the screen. 


LLIST [ < fine pumber > ] [ ~ < line number > } 
st al! of pert of the program on the printer. 


LOAD " [ < device descriptor > ) < filename > ~ 
Load 4 BASIC program jan ASCII file) trom the device. 


MAMFILES =n 
Specify the maximum number of files opened at » time 


MERGE “| < device descriptor > | < filename > ” 


Merge the lines from an ASCH program into the program 
currently in memory. 
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MOTOR ON/OFF 
Tum cassette motor on or off. 


NEW 
Delete entire program from working memory and reset alt 
verobles. 

RENUM [ < new number > | [ . < old number > | 

[. < increment > | 
Renumber program lines. 


RUN [ < line number > } 
Execute 3 program. 


SAVE “ < device descriptor > < filename > ~ 
Save the program in memory with name filename as an 
ASCII file, 


SOUND ON/OFF 
Tum sound of the cassette audio on or off, 


TRON 
Tum on trace for program execution. 


TROFF 
Tum wace off 


WIDTH no 
Set the display width on screen during text mode. n may be 
1-40 


BASIC STATEMENT 


CLOSE [ @ | < flenumber > [ . < filenumber > oll 
Close the channel and release the buffer associated with it. 


DATA < list of constants > 
Store the numeric and/or string constants thet ere eccessed 
by the READ statementis) 


DEF FN < name > [ < parameter list > | = < function 
definition > 
Define and name an arithmetic of string function 


DEF USR n = < eddrese> 
Define the entry eddress for the nth machine language routine 


DEFINT < ranges of letters > 

DEFSNG < ranges of letters > 

DEFSTR < ranges of letters > 
Declare variable type es integer, Single precision. double 
precision oF string. 


DIM < list of subscripted variables > 
Specity the maximum values for army variable subscripts end 
allocate storage sccordingly 


DRAW < string > 
Draw © figure according to the Graphic Macro Language 


END 
Terminate program execution. close all files and retum to 
command level 


ERASE < list of array variables > 
Eliminate arrays from « progrem 


ERROR n 
Generate error message of code n 


FOR < verieble> = x TO y [STEP 2 | 
NEXT | < variable > } 
Allow # series of instructions to be performed in a loop s given 
number of times. 
GOSUB < line number > 
RETURN [ < line number > | 
Branch to 8 subroutine and then retum from it. It < line 
number > ater RETURN is not specified. retum routne to the 
Statement following the lest GOSUB executed. 
GOTO < line number > 


Branch out of the normal program sequence to the specified 
fine number. 


\f < exp > THEN < statoment/ine > | ELSE < stetement/ine > | 
Make » decision reganting program flow based on the result 
returned by an expression. 


LET < variable > = < exp > 
Assign value of an expression to @ vanable. LET may be 


INPUT [ " < prompt string > “ ; | < list of variables > 
Allow input from keyboard dunng program execution. 


INPUT @ < filenumber > . < variable list > 
Read date items from the specified channel and assign them 
to program veriables 


INPUT S( 9 .[ # | < filenumber > ) 
Retum ao string of n characters, read from the file 


LINE INPUT [ “ < prompt string > “ ; ) < string variable > 
Input an entire line {up to 264 characters) to a string venable 


LINE INPUT # < filenumber > . < string variable > 
Read an entire line [up to 254 characters) from 9 sequential 
file to & string venable. 


LPRINT [ < list of exp > 
Print data at the printer. 


LPRINT USING “ < sting >” ; < list of exp > 
Print date at the printer using @ specified tormat. 


OPEN ~ < device descriptor > < filename > “ [ FOR < mode > | 
|< filenumber > 

Allocate a buffer for 1/0 and set the mode that will be used 
with the buffer. 


& 
. 


PLAY < string for voice 1 > |. < string for voice 2 > } 
{. < string for voice 3 > | 
Play music according to Music Macro Language. 


PRINT USING ~ < string > ~ ;: < list of exp > 
Print numeric or string expression using @ specified format 


PRINT @ < filenumber > . USING ~ < string > “ ; < list of exp > 
Write deta to the specified channel using a specified format. 


READ < list of variables > 
Read velues from a DATA statement and assign them to variables 


REM < remark > 
Allow explanatory remark to be inserted in # program. 


RESTORE [ < fine number > | 
Allow DATA statements to de reread from 2 specified line. 


RESUME (0) 
Resume execution at the statement causing an error. 


RESUME < line number > 
Resume executon at the specified line number. 


RESUME NEXT 
Resume executon at the statement immeckstely following the 
one causing an error 


SOUND < register of PSG > . < value > 
Put 9 valve into @ register to contro} the Programmable Sound 
Generator 


stor 
Terminate program execution and return to command level 
The “Break in <hne number > message is printed. 


SWAP < variable > . < variable > 
Exchange the velue of two vanables. 


WAIT < port > . < mask > [ . < select > | 
Suspend program execution read input at port until | <input bit >XOR 
<select > AND < mask >| retums # non-zero value. 


INTERRUPT CONTROL COMMAND AND STATEMENT 


INTERVAL ON/OFF /STOP 
To enable. disable. or terminate the BASIC timer interrupt 
tapping. 


KEY n ON/OFF/STOP 
To enable, disable, of terminate interrupts caused by a function 
key 


ON ERROR GOSUB < linenumber > 
Define the tine number of the subroutine to execute when an error 
has been detected 


ON ERROR GOTO < linenumber > 
Enable error trapping and specify the first line of the error handling 
subroutine. 


ON < exp > GOTO << list of linenumbers > 

ON < exp > GOSUB < list of linenumbers > 
Branch to one of several specitied line numbers. depending on 
the value returned when an expression is evaluated. 


ON INTERVAL = < exp > GOSUB < list af linenumbers > 
Set the line number to execute at every other machine interrupt 
cycle (60 per second) specified by < exp >. 


ON KEY (n) GOSUB << list of linenumbers > 
Specify the line number corresponding to the line offset nin the 
ee eee ee eee 
depress: 


ON STRIG GOSUB < linenumber > 
Define the starting line of the subroutine employed when any of 
the joystick button 1s depressed. (0 for space bar. 1 for Joystick 
1 of 2 for Joystick 2) 
201A 


ON SPRITE GOSUB < linenumber > 
Define jump address when sprites collision occurs 


ON STOP GOSUB < linenurmber > 


Define jump address when the CTAL + STOP keys are pressed. 


STOP ON/OFF /STOP 
To enable. disable, or terminate CTAL + STOP trapping 


STRIG ON/OFF /STOP 
To enable. disable. of terminate joystick button or space ber 
trapping. 


SPRITE ON/OFF /STOP 
To enable, chsable, of terminate the imerrupt generated when 
two of more sprites collide 


GRAPHIC COMMAND AND STATEMENT 

Clear grapinc screen. 
CIRCLE (x. y). < radius > [ . < color > [, < start > . < end >} 
[| . < aspect ratio > | 


CORES reeeen > 1b 5 Serene 29 |S eee 
the 


GET (( «1. v1.) —{ 42. y2))[. < color >] [. BF }) 
Read points from the graphic screen or trom defiend area of the 
Qraphic screen, Array must be dimensioned large enough to 
hold the dats. 


LINE [ (xt. yt) ] = 2 y2)[.[ < color >]. B(F }) 
Draw straight line connecting the two coordinate pairs specified 
orf 8 | F | is present draw or fill rectangle 


LOCATE x. y 
Position the graphic cursor to the staring coordianta pointed 
to by «. ¥) can used with LINE, POINT, PRINT. 


PAINT (x, y)[. < color > [, < low res mode border attribute > |} 
Fill in an arbitrary graphic figure of the specified fill color 
Paint must not have border for high res, while border must 
be specified in low res. 


POINT (x. y) 
Read the color of a pixel in the gmphic mode. 


PSET (x, y) [. < color > } 
Draw # dot at the assigned position on the screen using 
the foreground color or < color > if specified, 


PRESET (x. y) | . < color > } 
Some o8 PSET except draw in background color it <color > 
not specified. 


PUT (x, y), < arrayname > |. < operetion > | 
Output graphic patterns in the array to assigned position 
‘on the screen, operation can be: 
PSET: output pattern as is 
PRESET reverse pattern foreground/beckground color 
AND: combine graphic pattern color with screen pattem 


from the array and the screen are the same then that 
Pixel will be displayed in background color else it 
will be displayed in background color else it will be 
displayed in the foreground color 


PUT SPRITE < sprite plane > . (x. y)[, < color > } 
[. < pattern no > | 
Set up sprite attribute, when a field is omitted, the current 
value is used, see SPRITES. 
<em 11>) 
Use < exp 1 > to select graphic 
. < @ selects 


uion Move up 
Dan Move down 
ton Move lett 


Move right 

Move diagonally up and right 

Move diagonally down and nght 

Move diagonally down and left 

Move diagonally up and left 

Set scaling factor 

Move without plotting 

Move absolute or relative distance. if x has a 
plus sign (+) or a minus sign | —}in front of it, 
#* & relative. Otherwise. it is absolute. 

Move and return to original positon 

Set the angle, . 


Set color number 
Execute string. must be terminated by » 
semicolon. 


Zev 7s 
* 
22233339 


»z 
22 


con 
x <string> 


SOUND COMMAND AND STATEMENT 


SOUND statement is used to directly contro! the vanous capabilities of 
the Programmabie Sound Generator (PSG). It takes the form of: 
SOUND <register of PSG> . < value> 


The functions of the 13 PSG regesters are given below 
PSG Register Function 
Tone of channel A 


1 
.3 Tome of channel 8 
. 5 Tone of channel C 


Noise generator 
Mixer 


|87| 66] 85] 64] 63] 82] 8) | 60) 


Tone Channel 


Bit logical value: 1 to disable and O to 
enable 


~Oano 


8 Bit Oto 3amphtude contro! of channel A 
Bit 4 fixed amplitude contro! 


9 Bit O to 3amplitude contro! of channel B 
Bit 4: fixed amplitude contro! 


10 Bit 0 to 3:amplitude contro! of channel C 
Bit 4: fixed amplitude contro! 


Envelope period control range 


13 Envelope cycle /sl 
03.9% 47,15 A 
8 SNA AA 


pe control 


MUSIC MACRO LANGUAGE 


The PLAY command «6 used in conjunction with the following character 
stning to ploy & melody. 


Function 
Play the indicated note in the current octave 
A number sign ( # ) or plus sign (+) afterwards 
indicates # sharp. minus sign (—) indicates a 
flat. 
Set the length of the note. n may range from 
1 to 64. 
n Modulation sets period of envelope. n may 
range from 1 to 66535. 
n Play note n. m may renge from 0 to 96 in 7 
octaves 7. 2 = O means rest 
Octave. Set the octave of the notes to be played. 
Detoult is 4 
o Pouse of rest. n may range 1 to 64. 
n Set shape of noise output m can be 0 to 15. 
f Tempo. Set the number of quarter notes in a 
minute. n ranges from 32 to 255. Default is 120. 
Va Volume. Set the volume of output. n may range 
from © to 15. The default is 6. 
Dot or penod after each note causes it to be 
played 3/2 times the period determined by L 
times T_ 
x Execute specithed string 


PRINT USING FORMAT FIELD SPECIFIER 


String 
Ato G [@ of + jI-] 


> 


SOS OC 12 eg 
> 


‘String of numeric expression can be printed using a specified 
format. 


+ o 
iad ° 
oo 2 
ss 1 


ASC (< string > ) 
BINS jn) 
CHRS ft) 


FRE ( < exp >) 


HEXS ( < exp >} 
INKEYS 


INPUTS (length 
L.{#}m)) 


LEFTS (<string >, 
< length > } 


LEN {| < string >) 


MIDS [ < string > 
< stat >[, 
< length > | ) 


OCTS ( < exp >) 


RIGHTS | < strng >. 
< length >) 


SPACES (1) 
STRS | < exp >) 


i 
j 
i 


iH 
In 
t 


fi 
r 
i 
q 


2 
2 
3 
1 


Retum the ASCII value of the first 
character of string. 


Retum @ string which represents the 
binary value of n. 


Return a character having the ASCII 
code I. 


Returns remaining memory free space. 


Convert a number to a hexadecimal 
string. 


Return a one character string input from 
keyboard or null string if no input. 


Return a string having specified length 
read from the console or 8 file, 


Retum a length of leftmost characters 
of the string expression. 


Returm the number of characters in string. 


Return characters from the middie of the 
String starting at the position specified 
to the end of the string or for the 
specified length. 


Convert @ number to an octal string. 


Retum rightmost characters of the string 
expression. 


Retum a string of | spaces. 
Convert a numeric expression to a string. 


STRINGS (| < length >, Retum @ string with specified length 


< string > ) 


containing first character of string. 


STRINGS ( <length>, Retum string with specified 
1) containing 


VAL { < string > ) 


CVI ( < string >) 
CVS | < string > } 


CVD ( < sting >) 


MKIS ( < value >} 
MKSS ( <value > ) 


MKOS | < value > |} 


BASE jn) 
CSRUN 


first character with ASCII code |. 


Convert the string representation of » number 
to its numenc value. 


Convert a 2-charecter string to an integer. 


Convert a 4-charecter string to a single 
precision number. 


Convert an 8-character string to a double 
precision number, 


Convert an integer to a 2-charecter string. 


Convert a single precision velue to 
4-charecter string. 


Convent 3 double precision value to an 
B-character string, 


Current base address for each table. 
Retum the vertical coordinate of the cursor. 


EOF | < Glenumber > |Retum (-1) if the end of 2 sequential file 


ERL 
ERR 
PAD wm) 


has been reached. Otherwise, return { 0). 
Error line number. 

Error code number. 

Retum venous status of touch pad. 


PEEK (i) Reed « byte from memory location |. 

POS in) Retum the current horizontal postion of cursor. 
1 & @ Gummy argument. 

SPC A) Print | Blanks on the screen 

STICK in} Return the direction of » joystick 

STRIG (nj Retum the status of © trigger button of » 
joystick 

TAB A) Space to position | on the console. 


TIME An unsigned integer generated trom the 
System intemal wmer. 


USA | < digit >) Call the user's machine language subrounne 
{ argument ) with the specified argument 

VARPTR Retum the address of the first byte of date 
{ < venable > ) identified with < variable > 

VARPTR 


{® < filenumber > ) 


VOP in) For n = 0 to 7, this specifies the current 
velue of VOP's write onty register. 
For n = 8, it specifies the status register of 
vor 

OPERATOR 

Symbol Function 


~ Integer division 
moo Integer modulus 
Ones complement 
AND Bitwise AND 
OR Bitwise OR 
xoR Bitwise exclusively OR 
fav Bitwise equivalence 
ime Bitwise implication 
wy Gary Relational tests (result is either true (-1) 
>=.=<, of false (0) ) 


>e.a¢,<>,>< 


The precedence of operators is 


{1} Expressions in parentheses (8) Relational operators 


(2) Exponentiation (9) NOT 
(3) Negation (10) AND 
4) Mutnplication or Division (11) OR 

fs} Integer Division (12) XOR 
(6) MOD (13) IMP 


(7) Addition or Subtrection 
ARITHMETIC FUNCTION 
Function Action 


(14) av 


ABS ( < exp >} Absolute value of expression. 


ATN | < exp > | Arotangent of the expression, 


Convert the expression to # double precision 
number, 


Convert the expression to an integer 


CDBL ( < exp >) 


CINT ( < exp >) 


COS | < exp >) Cosine of the expression (in mdiens). 

CSNG (< exp >} Convert the expression to ® single precision 
number 

EXP ( < exp >} Raise the constant @ to the power of 
expression 

FIX | < exp >) Retum truncated integer of expression. 

FRE | <exp >} Give memory tree space not used by BASIC. 

INT (<exp >) Evaluate the expression for the largest integer 
calculated. 

LOG (| < exp >} Give the natural logarithm of the 
expression. 

AND (| < exp >} Generste a random number 
(<em> )<0 Seed new sequence 
{<ep >|]=0 Retum previous random 

number 

(Zep >] >0 or Retum new rendom 
omitted number 

SGN | < exp >} 1 @ expression > 0 
O expression = 0 
~1 if expression < 0 

SIN | < exp >) Sine of the expression jin radians} 

SOR ( < exp >) Square root of expression 

TAN { < exp >) Tangent of the expression fin radians) 


Angie is expressed or returned in radians. 
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